플랫폼 가용성
- 24시간 상태
- 99%
최근 30일
제공 기능
각 1688 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 상품 키워드로 1688 도매 상품을 나열합니다. | 요청 1,000개당 $2.78 | 양호 · 상태 100% |
상품 상세 정보product_detail | 상품 링크나 숫자 offerId로 1688 상품 하나를 가져옵니다. | 요청 1,000개당 $1.39 | 양호 · 상태 99% |
플랫폼 내 상품 이미지 검색image_search | image_url의 상품 사진 한 장을 1688과 대조해 제목, CNY 가격, 최소 주문량, 판매자, 링크가 포함된 유사 도매 상품을 최대 5개까지 가져옵니다. | 요청 1,000개당 $5.56 | 양호 · 상태 98% |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
1688 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 상품 키워드로 1688 도매 상품을 나열합니다. 가격 범위, 최소 주문 수량, 주문 수, 재구매율, 판매자 정보가 포함됩니다. 정렬 순서나 | keyword | city, max_price, min_price, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $2.78 | id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · supplier_type · supplier_years · supplier_shop_url · supplier_composite_score · sold_count_text · service_tags · product_badges · rating · rating_scale · review_count · positive_rate · sold_count · sold_display · want_buy_count · stock · unit · category_path · video_url · winport_url · supplier_fans · supplier_founded_year · price_tiers · specs · description_images · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
product_detail상품 상세 정보 상품 링크나 숫자 offerId로 1688 상품 하나를 가져옵니다. 수량별 단가, 최소 주문 수량, 재고, 옵션, 사양, 이미지, 판매자 정보가 포함됩니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · stock · sold_count · category · unit · supplier_name · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_dropship · supports_sampling · is_out_of_stock · skus · images · description_images · video_url · specs · rating · rating_scale · review_count · positive_rate · sold_display · want_buy_count · category_path · services · promotions · customization_supported · winport_url · city · province · supplier_years · package_dimensions · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
image_search플랫폼 내 상품 이미지 검색
| image_url | — | Sync 응답 | 카탈로그 값: defaultLimit=5, maxLimit=5. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $5.56 | id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform |
1688 search 파라미터는 각각 무엇을 의미하나요?
상품 키워드로 1688 도매 상품을 나열합니다. 가격 범위, 최소 주문 수량, 주문 수, 재구매율, 판매자 정보가 포함됩니다. 정렬 순서나 order_count가 정확한 판매량이나 최종 견적을 증명하지는 않습니다.
keyword필수- 1688 도매 상품 검색어를 지정합니다(예: 보온 머그컵, 골판지 상자). 상점 이름이나 offerId가 아니라 상품 관련 용어를 사용하세요. 최소 주문 수량과 구간별 가격은 상품 상세 정보에 포함되어 반환됩니다.
city선택- 1688 도매 상품 조회를 도시 이름 텍스트로 필터링합니다. 이 필터는 계정 위치를 반영하지 않고, 반환되는 판매자 주소를 바꾸지 않으며, 단일 상품 상세 요청에서도 필터가 유지된다고 보장하지 않습니다.
max_price선택- 도매 상품을 최고 단가(숫자)로 필터링합니다. 소수점을 사용할 수 있으며, 호출 시 위안 단위 정수 필터링을 대신 적용하는 경우에는 소수점을 올림하므로(145.98은 146이 됨) 범위는 넓어지기만 합니다. min_price와 함께 가격 범위를 제한하며, 주문 수량 구간을 정하지는 않습니다. 모든 SKU 옵션이나 수량 할인 구간을 포괄하지 않을 수 있습니다.
min_price선택- 도매 상품을 최저 단가(숫자)로 필터링합니다. 소수점을 사용할 수 있으며, 호출 시 위안 단위 정수 필터링을 대신 적용하는 경우에는 소수점을 내림하므로(39.81은 39가 됨) 범위는 넓어지기만 합니다. 이 파라미터는 상품 조건을 설정할 뿐 최소 주문 수량이나 API 지출 한도를 설정하지 않으며, 반환되는 구간별 가격은 주문 수량에 따라 다릅니다.
sort선택- 검색 결과 상품을 relevance(search 기본값), popular, price_asc, price_desc로 정렬합니다. 정렬 기준과 관계없이 응답에 정확한 판매량이나 총 거래액이 포함된다고 보장하지 않습니다.허용 값:
popularprice_ascprice_descrelevance
1688 product_detail 파라미터는 각각 무엇을 의미하나요?
상품 링크나 숫자 offerId로 1688 상품 하나를 가져옵니다. 수량별 단가, 최소 주문 수량, 재고, 옵션, 사양, 이미지, 판매자 정보가 포함됩니다. price_tiers는 수량이 늘어날수록 단가가 낮아지는 구간이며, 옵션 필드가 없다고 해서 해당 옵션이 품절이라는 뜻은 아닙니다.
url필수- product_detail에는 detail.1688.com 또는 m.1688.com의 상품 URL, 상품 URL이 정확히 하나 포함된 공유 메시지, 또는 숫자 offerId를 사용하세요. qr.1688.com 공유 링크는 상품 페이지로 안전하게 연결되는 경우에만 허용됩니다. 상점 페이지와 검색 페이지는 거부됩니다.1688: 상품, 규격, 최소 주문 수량 — 1688 구매 문서는 상품 offerId, 규격 specId, 구매 수량을 구분하고 최소 주문 수량을 별도로 검증합니다. 이 용어들은 설명 목적으로만 인용하며, 이 엔드포인트는 구매 주문을 생성하거나 미리 보는 기능을 지원하지 않습니다. · 확인일
1688 image_search 파라미터는 각각 무엇을 의미하나요?
image_url의 상품 사진 한 장을 1688과 대조해 제목, CNY 가격, 최소 주문량, 판매자, 링크가 포함된 유사 도매 상품을 최대 5개까지 가져옵니다. rank는 판매 순위가 아니라 이 이미지에 대한 일치 순서입니다.
image_url필수- image_search에는 공개 HTTPS 상품 이미지 URL 하나를 지정하세요. 이 액션은 이미지 하나를 제출해 일치하는 1688 상품을 최대 5개 반환하며, 상세 정보나 SKU 정보는 추가하지 않습니다.1688 오픈 플랫폼: 이미지로 유사 상품 찾기 — 1688 오픈 플랫폼은 이미지 URL이나 이미지 콘텐츠를 받는 공식 유사 상품 조회 기능을 문서화하고 있습니다. 이 자료는 플랫폼 차원에서 이미지로 상품을 조회하는 객체가 있음을 확인해 줄 뿐입니다. EveryInfra의 이미지 1장 제한, 최대 5개 결과, 응답 허용 목록, 과금, 전달 방식은 EveryInfra가 공개한 자체 문서에서 정의합니다. · 확인일
1688 API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"alibaba1688","action":"search","params":{"keyword":"<keyword>"}}'
1688 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
가격 스크래핑의 상업화: 판매자가 구독을 갱신하는 가격 모니터링 제품 만들기
판매자는 왜 가격 모니터링에 돈을 내고, 왜 구독을 해지할까요? 상품 매칭, 예외 목록, 가격 승인 워크플로를 통해 가격 데이터 제공 방식, 과금 단위, 파일럿 인수 기준을 살펴봅니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기API 실패, 크레딧 환불, 대사: 요청 한 건의 순과금액을 감사하는 방법
작업, 호출 시도, 전달 상태, 지갑 이벤트를 분리해 과금 전 거부, 빈 결과, 부분 크레딧 환불을 중복 집계 없이 처리하며, 정수 기반 오프라인 예시를 사용합니다.
글 읽기1688 API 자주 묻는 질문
1688 API로 무엇을 가져올 수 있나요?
platform을 alibaba1688 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상품 상세 정보 및 플랫폼 내 상품 이미지 검색입니다. 각 액션 이름은 서로 다른 1688 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
1688에 공식 API가 있나요?
Alibaba의 1688 Open Platform은 1688 판매자용 도구와 1688에서 소싱하거나 드롭쉬핑하는 구매자용 도구(상품 등록, 주문 관리, 해외 구매 도구 등)를 만드는 소프트웨어 벤더를 위한 플랫폼이며, 1,600곳 이상의 파트너 벤더가 등록되어 있습니다.
공식 출처: 1688 Open Platform · 확인일
1688 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. 1688 개발자 앱을 등록하거나, 1688 API 접근을 신청하거나, 1688 계정으로 로그인할 필요가 없으며, 액션은 공개된 1688 데이터만 반환합니다.
1688 API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $1.39부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
1688 search 요청에는 어떤 입력이 필요한가요?
1688 도매 상품 검색어를 지정합니다(예: 보온 머그컵, 골판지 상자). 상점 이름이나 offerId가 아니라 상품 관련 용어를 사용하세요. 최소 주문 수량과 구간별 가격은 상품 상세 정보에 포함되어 반환됩니다. params 안의 keyword 필드로 전달하세요.
1688 search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, price_min 및 price_max입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 1688 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.