플랫폼 가용성
- 24시간 상태
- 100%
최근 30일
제공 기능
각 Taobao 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 Taobao와 Tmall 상품 정보를 검색합니다. | 요청 1,000개당 $13.5 | 양호 · 상태 98% |
상품 상세 정보product_detail | Taobao 또는 Tmall 상품 하나의 전체 레코드를 가져옵니다. | 요청 1,000개당 $4.5 | 양호 · 상태 100% |
숍shop | Taobao 판매자가 현재 판매 중인 상품을 최대 20개까지 나열합니다. | 요청 1,000개당 $1.39 | 양호 · 상태 100% |
리뷰reviews | Taobao 상품의 구매자 리뷰를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
질문questions | Taobao 상품 페이지의 구매자 질문과 답변을 가져오며, 각 질문의 답변 수와 게시일을 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Taobao 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 Taobao와 Tmall 상품 정보를 검색합니다. 가격과 발송지, 그리고 제공되는 경우 판매량, 평점, 상점, 쿠폰 또는 할인 정보를 받을 수 있습니다. 일반 키워드 검색이 가장 안정적이며 | keyword | max_price, min_price, page, sort, tmall_only | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=20. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $13.5 | id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · shop_id · sold_text · original_price · coupon_price · discount_type · is_tmall · brand · category_id · seller_credit_level · seller_positive_rate · shop_score_description · shop_score_service · shop_score_delivery · subtitle · search_rank · free_shipping · selling_points · review_tags · images · discount_rate · spu_id · category_path · review_count · latest_review · seller_type · shop_opened_at · shop_age_years · shop_item_count · shop_score_vs_industry · platform |
product_detail상품 상세 정보 Taobao 또는 Tmall 상품 하나의 전체 레코드를 가져옵니다. 브랜드, 가격, 재고, 모든 SKU, 속성, 이미지, 배송비, 상점 평점이 포함됩니다. 숫자 상품 ID, 상품 링크 또는 상품 링크가 정확히 하나 포함된 공유 텍스트를 전달하세요. 공유 코드만 있거나 만료된 링크는 거부됩니다. | url | — | Sync 응답 | — | 요청 1,000개당 $4.5 | id · url · title · brand · price · original_price · currency · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · ems_fee · express_fee · skus · sku_count · spec_values · props_images · attributes · main_image_url · description_images · description_html · video_url · coupon_price · price_usd · total_price · suggestive_price · has_discount · is_promotion · promo_type · is_virtual · brand_id · root_category_id · category_path · weight · size · favorite_count · fans_count · min_order_quantity · shipping_to · listed_at · modified_at · delist_at · images · category_name · description · keywords · titleOriginal · has_cn_title · shop_score_description · shop_score_service · shop_score_delivery · free_shipping · promotion_price · discount_price · discount_type · price_note · has_price_range · payment_methods · seller_id · seller_credit_level · seller_type · seller_type_label · selling_points · shop_logo_url · shop_url · shop_item_count · shop_new_item_count · shop_opened_at · review_tags · review_count · positive_rate · seven_day_return · reviews · platform |
shop숍 Taobao 판매자가 현재 판매 중인 상품을 최대 20개까지 나열합니다. 취소선이 그어진 할인 전 가격, 카테고리, 배송비 포함 여부 플래그, 대표 이미지, 상점 평점을 받을 수 있으며, 행에는 판매량이나 리뷰 수가 없습니다. | shop | seller, sort, user_id | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=20. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 20까지만 적용됩니다. | 요청 1,000개당 $1.39 | id · url · title · original_price · currency · category_id · free_shipping · shop_name · shop_id · seller_id · image_url · shop_url · shop_logo_url · shop_score_description · shop_score_service · shop_score_delivery · shop_item_count · platform |
reviews리뷰 Taobao 상품의 구매자 리뷰를 읽어 옵니다. 각 리뷰에는 평점, 구매한 옵션, 도움이 됨 투표 수, 사진, 추가 리뷰, 판매자 답글이 포함됩니다. 상품 ID, 상품 링크 또는 상품 링크가 하나 포함된 공유 텍스트를 전달하세요. 한 번에 모든 리뷰가 포함되지 않을 수 있습니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · author_avatar_url · images · review_append · platform · seller_reply |
questions질문 Taobao 상품 페이지의 구매자 질문과 답변을 가져오며, 각 질문의 답변 수와 게시일을 제공합니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · answer_count · posted_at · answers · platform |
Taobao search 파라미터는 각각 무엇을 의미하나요?
키워드로 Taobao와 Tmall 상품 정보를 검색합니다. 가격과 발송지, 그리고 제공되는 경우 판매량, 평점, 상점, 쿠폰 또는 할인 정보를 받을 수 있습니다. 일반 키워드 검색이 가장 안정적이며 page로 페이지당 20개씩 넘길 수 있지만, 대부분의 행에 판매량과 상점 이름이 없습니다. 가격 범위, popular, price_desc, tmall_only는 페이지를 넘길 수 없으며, 이 중 뒤의 세 가지는 요청당 결과가 10개로 제한됩니다. 재고, 정품 여부, 배송은 확인되지 않습니다.
keyword필수- search 액션에서 사용할 Taobao 또는 Tmall 상품 검색어를 지정합니다. 스토어 이름으로 정확히 일치하는 검색은 수행하지 않습니다.
max_price선택- min_price와 함께 search 액션의 최대 상품 가격 필터를 설정합니다. SKU 재고 한도를 제어하지 않습니다. 소수 값은 정수로 올림될 수 있습니다. 가격 범위를 지정한 검색은 페이지네이션을 지원하지 않습니다.
min_price선택- search 액션의 최소 상품 가격 필터를 설정합니다. 리뷰 점수 필터나 API 요금 파라미터가 아니며, shop, product_detail, reviews, questions에는 적용되지 않습니다. 소수 값은 정수로 내림될 수 있습니다. 가격 범위를 지정한 검색은 페이지네이션을 지원하지 않습니다.
page선택- 상품 검색의 페이지 번호로, 1~50 사이 값이며 페이지당 결과는 20개입니다. 1페이지는 생략하면 되며, 각 페이지는 API 호출 1회로 과금됩니다. 단순 키워드 검색만 페이지네이션을 지원합니다(min_price, max_price, tmall_only 없이, sort는 생략하거나 relevance). 이 방식이 더 안정적인 검색 방법이지만, 대부분의 행에는 판매량이나 상점 이름이 없습니다. 이 필터 중 하나와 함께 1보다 큰 페이지를 요청하면 과금 전에 거부되므로, 페이지네이션하려면 해당 필터를 제거하세요. limit은 해당 페이지에서 받을 결과 수만 지정하므로 페이지네이션 시에는 20으로 유지하세요. 순위가 실시간으로 바뀌므로 인접한 페이지에 일부 항목이 중복될 수 있습니다. 페이지를 합칠 때는 id로 중복을 제거하세요.
sort선택- 상품 검색에는 relevance(기본값), popular, price_desc를 사용합니다. 기본값과 relevance 검색은 최대 20개 결과를 받을 수 있고, popular와 price_desc는 최대 10개이며 페이지네이션을 지원하지 않습니다. 해당 한도를 초과하는 요청은 과금 전에 거부되며, price_asc는 지원하지 않습니다. reviews와 questions는 sort를 받지 않습니다. shop은 오류 없이 받지만 현재는 효과가 없습니다.허용 값:
popularprice_descrelevance tmall_only선택- boolean true로 설정하면 상품 검색을 Tmall 상품으로만 필터링하며, 요청 결과는 최대 10개로 제한되고 페이지를 넘길 수 없습니다. JSON boolean만 전달하세요. "false" 같은 문자열이나 이 한도를 초과하는 요청은 과금 전에 거부됩니다.
Taobao product_detail 파라미터는 각각 무엇을 의미하나요?
Taobao 또는 Tmall 상품 하나의 전체 레코드를 가져옵니다. 브랜드, 가격, 재고, 모든 SKU, 속성, 이미지, 배송비, 상점 평점이 포함됩니다. 숫자 상품 ID, 상품 링크 또는 상품 링크가 정확히 하나 포함된 공유 텍스트를 전달하세요. 공유 코드만 있거나 만료된 링크는 거부됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- product_detail, reviews, questions에는 숫자 상품 ID, Taobao/Tmall 상품 URL, 또는 상품 URL이 정확히 하나 포함된 공유 메시지를 사용합니다. e.tb.cn과 m.tb.cn 링크는 상품 페이지로 안전하게 변환될 수 있을 때만 작동합니다. TaoPassword 토큰만 있는 입력, 만료된 링크, 상품 페이지가 아닌 링크는 거부됩니다.Taobao: 상품 ID와 SKU 용어 — Taobao는 상품 링크의 id= 뒤에 오는 숫자를 상품 ID로 정의하며, SKU는 색상, 사이즈 같은 특정 속성 조합을 나타냅니다. 상품 ID와 SKU를 서로 바꿔 쓰면 안 됩니다. · 확인일
Taobao shop 파라미터는 각각 무엇을 의미하나요?
Taobao 판매자가 현재 판매 중인 상품을 최대 20개까지 나열합니다. 취소선이 그어진 할인 전 가격, 카테고리, 배송비 포함 여부 플래그, 대표 이미지, 상점 평점을 받을 수 있으며, 행에는 판매량이나 리뷰 수가 없습니다. shop에는 상점 이름이 아니라 판매자의 숫자 사용자 ID나 상점 링크를 전달합니다.
shop필수- shop 액션에 사용할 판매자의 숫자 userId(sellerId) 또는 상점 링크(shop<shopId>.taobao.com)를 지정합니다. 해당 판매자가 판매 중인 상품을 요청당 최대 20개 반환합니다. limit을 더 크게 설정해도 20개가 반환되며, 호출당 가격은 같습니다. 상점 이름이 아닙니다.
seller선택- shop 액션에서 판매자의 숫자 userId를 위한 호환용 대체 입력입니다. 판매자 닉네임은 받지 않고 숫자 사용자 ID만 받으며, shop과 user_id보다 우선순위가 낮습니다.
sort선택- 상품 검색에는 relevance(기본값), popular, price_desc를 사용합니다. 기본값과 relevance 검색은 최대 20개 결과를 받을 수 있고, popular와 price_desc는 최대 10개이며 페이지네이션을 지원하지 않습니다. 해당 한도를 초과하는 요청은 과금 전에 거부되며, price_asc는 지원하지 않습니다. reviews와 questions는 sort를 받지 않습니다. shop은 오류 없이 받지만 현재는 효과가 없습니다.허용 값:
best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales user_id선택- shop 액션에서 판매자의 숫자 userId를 위한 호환용 대체 입력입니다. shop보다 우선순위가 낮으며 상품 ID로 사용할 수 없습니다.
Taobao reviews 파라미터는 각각 무엇을 의미하나요?
Taobao 상품의 구매자 리뷰를 읽어 옵니다. 각 리뷰에는 평점, 구매한 옵션, 도움이 됨 투표 수, 사진, 추가 리뷰, 판매자 답글이 포함됩니다. 상품 ID, 상품 링크 또는 상품 링크가 하나 포함된 공유 텍스트를 전달하세요. 한 번에 모든 리뷰가 포함되지 않을 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- product_detail, reviews, questions에는 숫자 상품 ID, Taobao/Tmall 상품 URL, 또는 상품 URL이 정확히 하나 포함된 공유 메시지를 사용합니다. e.tb.cn과 m.tb.cn 링크는 상품 페이지로 안전하게 변환될 수 있을 때만 작동합니다. TaoPassword 토큰만 있는 입력, 만료된 링크, 상품 페이지가 아닌 링크는 거부됩니다.Taobao: 상품 ID와 SKU 용어 — Taobao는 상품 링크의 id= 뒤에 오는 숫자를 상품 ID로 정의하며, SKU는 색상, 사이즈 같은 특정 속성 조합을 나타냅니다. 상품 ID와 SKU를 서로 바꿔 쓰면 안 됩니다. · 확인일
Taobao questions 파라미터는 각각 무엇을 의미하나요?
Taobao 상품 페이지의 구매자 질문과 답변을 가져오며, 각 질문의 답변 수와 게시일을 제공합니다. answer_count는 반환된 답변 수와 다를 수 있으며, 답변이 판매자가 작성한 것이라는 보장은 없습니다.
url필수- product_detail, reviews, questions에는 숫자 상품 ID, Taobao/Tmall 상품 URL, 또는 상품 URL이 정확히 하나 포함된 공유 메시지를 사용합니다. e.tb.cn과 m.tb.cn 링크는 상품 페이지로 안전하게 변환될 수 있을 때만 작동합니다. TaoPassword 토큰만 있는 입력, 만료된 링크, 상품 페이지가 아닌 링크는 거부됩니다.Taobao: 상품 ID와 SKU 용어 — Taobao는 상품 링크의 id= 뒤에 오는 숫자를 상품 ID로 정의하며, SKU는 색상, 사이즈 같은 특정 속성 조합을 나타냅니다. 상품 ID와 SKU를 서로 바꿔 쓰면 안 됩니다. · 확인일
Taobao 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":"taobao","action":"search","params":{"keyword":"<keyword>"}}'
Taobao 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
가격 스크래핑의 상업화: 판매자가 구독을 갱신하는 가격 모니터링 제품 만들기
판매자는 왜 가격 모니터링에 돈을 내고, 왜 구독을 해지할까요? 상품 매칭, 예외 목록, 가격 승인 워크플로를 통해 가격 데이터 제공 방식, 과금 단위, 파일럿 인수 기준을 살펴봅니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기API 실패, 크레딧 환불, 대사: 요청 한 건의 순과금액을 감사하는 방법
작업, 호출 시도, 전달 상태, 지갑 이벤트를 분리해 과금 전 거부, 빈 결과, 부분 크레딧 환불을 중복 집계 없이 처리하며, 정수 기반 오프라인 예시를 사용합니다.
글 읽기Taobao API 자주 묻는 질문
Taobao API로 무엇을 가져올 수 있나요?
platform을 taobao 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상품 상세 정보, 숍, 리뷰 및 질문입니다. 각 액션 이름은 서로 다른 Taobao 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Taobao에 공식 API가 있나요?
Taobao Open Platform은 Taobao·Tmall 판매자를 위한 도구를 만드는 소프트웨어 벤더, 서비스 파트너, 브랜드를 대상으로 합니다. 상품, 주문 같은 스토어 데이터는 판매자가 앱에 권한을 부여할 때 발급되는 액세스 토큰으로 읽으며, 구매자 대상 앱에는 대신 Taobao 제휴(Taobaoke) 상품 API가 제공됩니다.
공식 출처: Taobao Open Platform: introduction · Taobao Open Platform: integration guide · 확인일
Taobao 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. Taobao 개발자 앱을 등록하거나, Taobao API 접근을 신청하거나, Taobao 계정으로 로그인할 필요가 없으며, 액션은 공개된 Taobao 데이터만 반환합니다.
Taobao API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $1.39부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
Taobao search 요청에는 어떤 입력이 필요한가요?
search 액션에서 사용할 Taobao 또는 Tmall 상품 검색어를 지정합니다. 스토어 이름으로 정확히 일치하는 검색은 수행하지 않습니다. params 안의 keyword 필드로 전달하세요.
Taobao search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, price, currency 및 sold_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Taobao 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.