자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Taobao 상품 상세 정보 API

POST

API 상태

24시간 상태
100%
24시간 평균 소요 시간
13.64 s
  • 양호 / 정상
  • 사용 가능
  • 제한적
  • 대부분 작동 중단
양호

Taobao 또는 Tmall 상품 하나의 전체 레코드를 가져옵니다. 브랜드, 가격, 재고, 모든 SKU, 속성, 이미지, 배송비, 상점 평점이 포함됩니다. 숫자 상품 ID, 상품 링크 또는 상품 링크가 정확히 하나 포함된 공유 텍스트를 전달하세요. 공유 코드만 있거나 만료된 링크는 거부됩니다.

Taobao 상품 상세 기능은 Taobao 또는 Tmall 상품 하나의 공개 레코드 전체를 읽어옵니다. 제목, 브랜드, 가격과 정가, 쿠폰 적용가, 재고와 판매량, 개별 가격과 재고가 포함된 모든 SKU, 상품 속성, 대표 이미지와 상세 설명 이미지, 그리고 상점 정보와 배송비가 포함됩니다. 경쟁사 상품 정보 분석, 가격 및 프로모션 추적, 판매 조건 비교, 상품 카탈로그 보강에 활용할 수 있습니다.

url에는 숫자 상품 ID, 상품 링크, 또는 상품 링크가 정확히 하나 포함된 공유 텍스트를 넣을 수 있습니다. Taobao 공유 코드만 단독으로 넣거나 만료된 링크를 넣으면 거부됩니다. 가격을 읽을 때 coupon_price는 쿠폰이 적용될 때만 나타나며, skus의 각 항목에 개별 가격이 있을 수 있다는 점에 유의하십시오. is_tmall로 Tmall 스토어와 일반 Taobao 상점을 구분할 수 있으며, 두 유형은 요건과 보장 내용이 다릅니다.

요금은 요청 1,000개당 $4.5(호출당 $0.0045)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.

AI 프롬프트

EveryInfra Taobao 상품 상세 정보 엔드포인트(taobao/product_detail)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 taobao, action은 product_detail로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
  - url: product_detail, reviews, questions에는 숫자 상품 ID, Taobao/Tmall 상품 URL, 또는 상품 URL이 정확히 하나 포함된 공유 메시지를 사용합니다. e.tb.cn과 m.tb.cn 링크는 상품 페이지로 안전하게 변환될 수 있을 때만 작동합니다. TaoPassword 토큰만 있는 입력, 만료된 링크, 상품 페이지가 아닌 링크는 거부됩니다.
- 단일 객체를 반환합니다. 주요 필드: id, url, title, brand (브랜드입니다), price (통화 기호 없는 숫자 가격이며, currency를 참고하세요), original_price (원래 가격(취소선 가격)입니다), currency, stock (재고입니다), sold_count (판매 수량입니다), category_id (카테고리 ID입니다), location, is_tmall (상점이 일반 Taobao 상점이 아니라 Tmall 상점인지 여부입니다); 전체 필드 77개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- 요청 본문 예시:
{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}
- 요금: 요청 1,000개당 $4.5. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.

요청 파라미터

이름위치타입필수기본값설명
Authorizationheaderstring예-Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
platformbodystring예taobao플랫폼 식별자이며 고정값입니다.
actionbodystring예product_detail기능 식별자이며 고정값입니다.
urlbody.paramsstring예-product_detail, reviews, questions에는 숫자 상품 ID, Taobao/Tmall 상품 URL, 또는 상품 URL이 정확히 하나 포함된 공유 메시지를 사용합니다. e.tb.cn과 m.tb.cn 링크는 상품 페이지로 안전하게 변환될 수 있을 때만 작동합니다. TaoPassword 토큰만 있는 입력, 만료된 링크, 상품 페이지가 아닌 링크는 거부됩니다.

코드 샘플

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}'

OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

실제 응답

October 24, 2026 at 18:28(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다. id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.

json
{
  "id": "req_…",
  "platform": "taobao",
  "action": "product_detail",
  "results": {
    "id": "•••",
    "url": "https://item.taobao.com/item.htm?id=744983869996",
    "title": "绿联转换插头英标韩国马来西亚澳洲新加坡新西兰Switch转换器充电",
    "price": 29.97,
    "currency": "CNY",
    "stock": 1397,
    "category_id": "50003472",
    "location": "廣東東莞",
    "is_tmall": true,
    "shop_name": "绿联数码旗舰店",
    "shop_id": "67095450",
    "skus": [
      {
        "id": "•••",
        "name": "[for Outings] English to Chinese Converter|Matte Black⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",
        "price": 30.17,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i3/713464357/O1CN01QOFAISCEu2L1chua_!!713464357.jpg"
      },
      {
        "id": "•••",
        "name": "[for Outings] English to Chinese Converter|Lightweight White⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",
        "price": 29.97,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01P9gIa5t80pC1chua_!!713464357.jpg"
      },
      {
        "id": "•••",
        "name": "[for Mainland China] Chinese to English Converter|Matte Black⭐Applicable to Hong Kong Version of Ps5/Switch2/Electrical Appliances in Hong Kong and Macau, China",
        "price": 30.17,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01WLbh5e1i3YjKWsf7g_!!713464357.jpg"
      }
    ],
    "sku_count": 8,
    "main_image_url": "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",
    "description_images": [
      "https://img.alicdn.com/imgextra/i1/713464357/O1CN01tRpmSz1MdQI1WPZ8_!!713464357.jpg",
      "https://img.alicdn.com/imgextra/i1/713464357/O1CN019muBmB1i3YpL3L8sM_!!713464357.jpg",
      "https://img.alicdn.com/imgextra/i3/713464357/O1CN011J4LMz1i3Ynq3SQ1z_!!713464357.jpg"
    ],
    "price_usd": 5.27,
    "root_category_id": "50020579",
    "category_path": "首页 > 电子/电工 > 接线板/插头 > 转换插头",
    "min_order_quantity": 1,
    "images": [
      "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01f4WmsN1i3YoKlcotr_!!713464357.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01KQ3NjW1i3YljOLkIv_!!713464357.jpg"
    ],
    "category_name": "转换插头",
    "description": "港版Switch转换插头 - 英标转中转换器,适用马来西亚插头与多国转换插头,具备65W快充功能。适合港版Switch 1与2使用,提供全球适用的转换解决方案。\n\n多国适用与高效快充功能 - 绿联多国转换插头支援英标、美标、德标与澳标等多种插头类型,适用全球多数国家与地区。内建65W快充技术,确保高功率需求的装置如Switch主机与笔电能快速充电,同时具备安全保护机制,避免过载与短路。\n\n多样款式与便利设计选择 - 转换插头提供多种款式选择,包含单独英转中、中转英与多合一组合。特别针对港版Switch 2使用者设计,提供适用进口电器的转换方案。轻巧便携设…",
    "keywords": [
      "港版Switch转换插头",
      "英标转中转换器",
      "适用马来西亚插头"
    ],
    "shop_score_description": 4.8,
    "shop_score_service": 4.8,
    "shop_score_delivery": 4.9,
    "free_shipping": false,
    "has_price_range": true,
    "payment_methods": [
      "蚂蚁花呗",
      "信用卡支付",
      "集分宝"
    ],
    "seller_id": "•••",
    "seller_credit_level": 20,
    "seller_type": "B",
    "seller_type_label": "Business seller",
    "selling_points": [
      "港版Switch2转换插头:专为港版Switch2设计转换插头,兼容多国电压,出国携带无烦恼。",
      "绿联品牌认证转换器:知名电子品牌绿联出品,通过多国安全认证,使用更安心。",
      "多国插头规格适用:适用马来西亚、新加坡、英国等多国插座标准,国际旅行首选。"
    ],
    "shop_logo_url": "https://img.alicdn.com/imgextra//d2/82/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg",
    "shop_url": "https://shop.m.taobao.com/shop/shop_index.htm?user_id=713464357",
    "shop_item_count": 1330,
    "shop_new_item_count": 28,
    "shop_opened_at": "2011-05-30 14:37:22",
    "seven_day_return": false,
    "reviews": [
      {
        "text": "还不错,通电了装换头会有提示灯 没送收纳袋。 体积挺小巧的。 手感挺细腻的。",
        "rating": 5,
        "posted_at": "2026.10.17 18:07",
        "sku": "颜色:【内地用】中转英转换器|轻骑白⭐港版PS5/Switch2/中国香港澳门地区电器适用",
        "author_avatar_url": "https://gw.alicdn.com/•••"
      }
    ],
    "platform": "taobao"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.

필드의미
id플랫폼에서 레코드의 고유 ID입니다. 한 플랫폼 안에서만 고유하며, 플랫폼이 다르면 ID가 중복될 수 있습니다.
url플랫폼에서 해당 레코드로 연결되는 링크입니다.
title제목입니다. 플랫폼에 제목이 없으면 null입니다(예: 텍스트 전용 게시물).
brand브랜드입니다.
price통화 기호 없는 숫자 가격이며, currency를 참고하세요. product_detail에서는 가격(각 skus 행의 price 포함)이 대부분 미국 달러에서 환산된 값이라 Taobao 페이지 가격과 약 1–4% 차이가 날 수 있습니다. 기준은 페이지 가격입니다.
original_price원래 가격(취소선 가격)입니다. shop에서는 유일한 가격으로, 상품 정보에 표시된 취소선 가격이지 판매 가격이 아니며 판매 가격보다 훨씬 높을 수 있습니다. 판매 가격은 product_detail을 사용하세요.
currency가격의 통화 코드입니다(예: CNY, USD). price는 있는데 currency가 null이면 통화를 추정하지 마세요.
stock재고입니다.
sold_count판매 수량입니다.
category_id카테고리 ID입니다.
location위치 설명을 그대로 전달하며, 형식은 플랫폼마다 다릅니다.
is_tmall상점이 일반 Taobao 상점이 아니라 Tmall 상점인지 여부입니다. 두 유형은 입점 요건과 구매자 보장이 다릅니다.
shop_name상점 이름입니다.
shop_id상점 ID입니다.
shipping_fee배송비입니다.
ems_feeEMS 배송비입니다.
express_fee택배 배송비입니다.
skus상품 정보의 모든 옵션(SKU)입니다. 각 항목에는 id, name, price, original_price, coupon_price, stock, props_ids, image_url 필드가 포함될 수 있으며, price 값은 대부분 미국 달러에서 환산된 금액입니다(price 참고).
sku_countSKU 수입니다.
spec_values판매되지 않는 조합을 포함한 전체 옵션 값 표입니다. id는 값을 식별하고 text는 해당 라벨입니다.
props_images옵션 값별 이미지입니다. id는 spec_values 및 props_ids와 일치하며, image_url은 해당 옵션의 표시 이미지입니다.
attributes브랜드, 모델, 원산지 등 상품 속성을 {name, value} 행으로 제공합니다.
main_image_url메인(첫 번째) 이미지입니다.
description_images설명 영역의 긴 이미지로, 페이지 순서대로 제공됩니다.
description_html설명 영역의 원본 HTML로, 대부분 이미지 태그입니다.
video_url메인 이미지 동영상의 직접 링크입니다. 동영상을 가져올 수 있는 경우가 드물어 이 필드는 보통 비어 있으며, 값이 비어 있다고 해서 상품에 동영상이 없는 것은 아닙니다.
coupon_price쿠폰 적용 후 가격입니다. 쿠폰이 적용되면 price보다 낮고, 그렇지 않으면 포함되지 않습니다.
price_usd반환 데이터에서 환산된 미국 달러 기준 참고 가격입니다.
total_price반환된 그대로의 총 가격으로, 없는 경우가 많습니다.
suggestive_price권장 소비자 가격으로, 없는 경우가 많습니다.
has_discount할인 적용 여부입니다.
is_promotion상품의 프로모션 진행 여부입니다.
promo_type프로모션 유형입니다.
is_virtual가상 상품(실물이 아닌 상품) 여부입니다.
brand_id브랜드 ID입니다.
root_category_id최상위 카테고리 ID입니다.
category_path카테고리 경로(브레드크럼)입니다.
weight반환된 그대로의 상품 무게입니다. 0이거나 없는 경우가 많습니다.
size상품 크기입니다. 없는 경우가 많습니다.
favorite_count상품이 즐겨찾기에 추가된 횟수입니다.
fans_count반환된 그대로의 팔로워 수입니다. 없는 경우가 많습니다.
min_order_quantity최소 주문 수량입니다.
shipping_to배송 지역 안내입니다. 없는 경우가 많습니다.
listed_at상품 등록 시각(ISO 8601)입니다. 데이터에 값이 없으면 필드가 생략됩니다.
modified_at최종 수정 시각(ISO 8601)입니다. 데이터에 값이 없으면 필드가 생략됩니다.
delist_at판매 중지 시각(ISO 8601)입니다. 데이터에 값이 없으면 필드가 생략됩니다.
images이미지 링크입니다. product_detail에서는 상품 사진, reviews에서는 구매자가 올린 사진입니다(리뷰에 사진이 없으면 생략됩니다).
category_name최하위 카테고리 이름입니다(product_detail).
description요약 또는 설명으로, 보통 text보다 짧습니다.
keywords상품 페이지의 키워드입니다(product_detail).
titleOriginal플랫폼 자체의 의미를 따름
has_cn_title플랫폼 자체의 의미를 따름
shop_score_description상품 설명 일치도에 대한 상점 평점(5점 만점)입니다.
shop_score_service서비스에 대한 상점 평점(5점 만점)입니다.
shop_score_delivery배송에 대한 상점 평점(5점 만점)입니다.
free_shipping무료 배송 여부입니다.
promotion_price프로모션 가격입니다(product_detail, 없는 경우가 많음).
discount_price할인 가격입니다(product_detail, 없는 경우가 많음).
discount_type표기 그대로의 할인 또는 캠페인 유형입니다(예: 타임 세일).
price_note표기 그대로의 가격 안내입니다(product_detail).
has_price_range옵션별 가격이 달라 가격이 범위로 표시되는지 여부입니다(product_detail).
payment_methods지원되는 결제 수단입니다(product_detail).
seller_id판매자 ID입니다(shop에서는 없을 수 있음).
seller_credit_level판매자 신용 등급입니다(숫자이며 높을수록 좋음).
seller_type판매자 유형 코드입니다(product_detail).
seller_type_label판매자 유형 이름입니다(product_detail). 예: Tmall, 기업 상점.
selling_points셀링 포인트 태그입니다.
shop_logo_url상점 로고 링크입니다(product_detail, shop). shop에서는 없을 수 있습니다.
shop_url상점 링크입니다(product_detail, shop).
shop_item_count상점에서 판매 중인 상품 수입니다(product_detail, search, shop).
shop_new_item_count상점의 신상품 수입니다(product_detail).
shop_opened_at표기 그대로의 상점 개설 시점입니다(product_detail).
review_tags리뷰 태그입니다. 각 항목에는 tag(라벨)와 count(언급 횟수, 없을 수 있음)가 있습니다.
review_count리뷰 수로, 상품 및 업체 관련 기능에 해당합니다. null은 비공개라는 뜻이며, 0이 아닙니다.
positive_rate상품 긍정 리뷰 비율로, 백분율 값이며 없는 경우가 많습니다(product_detail).
seven_day_return사유 불문 7일 반품을 지원하는지 여부입니다(product_detail).
reviews플랫폼 자체의 의미를 따름
platform출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).

FAQ

url에는 무엇을 전달할 수 있나요?

숫자 상품 ID, Taobao 또는 Tmall 상품 링크, 또는 상품 링크가 정확히 하나 포함된 공유 텍스트를 전달할 수 있습니다. e.tb.cn과 m.tb.cn 단축 링크는 상품 페이지로 안전하게 연결되는 경우에만 허용됩니다. 공유 코드만 단독으로 넣거나 만료된 링크, 상점 페이지 또는 검색 페이지를 넣으면 거부됩니다.

옵션이 여러 개인 상품의 가격은 어떻게 읽나요?

skus에는 모든 옵션이 나열되며, 옵션마다 가격, 정가, 쿠폰 적용가, 재고가 따로 있을 수 있습니다. price는 상품 단위의 값입니다. 가격을 비교하거나 모니터링할 때는 옵션별로 기록하십시오. spec_values에는 판매하지 않는 조합을 포함한 모든 옵션 값이 담깁니다.

가격은 위안화인가요? 미국 달러 가격도 있나요?

price, original_price, coupon_price는 통화 기호 없는 숫자이므로 통화를 추정하지 말고 currency에서 확인하십시오. price_usd는 반환 데이터에서 환산된 미국 달러 기준 참고 가격입니다. 대략적인 비교에만 사용하고 실제 결제 금액으로 보지 마십시오. 상품 상세의 위안화 가격은 대부분 미국 달러에서 환산된 값이라 Taobao 페이지 가격보다 약 1~4% 높거나 낮을 수 있으며, 기준은 페이지 가격입니다.

오류 및 과금

401
키가 없거나 유효하지 않습니다.
402
잔액이 부족합니다. 먼저 충전하세요.
422
파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
429
분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
503
처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
200 빈 결과
데이터가 없습니다. 과금되지 않습니다.

오류

공식 참고 자료

객체와 용어를 확인하는 용도로만 사용합니다. 해당 플랫폼이 EveryInfra를 승인하거나 보증한다는 의미는 아닙니다.

  • Taobao: 상품 ID와 SKU 용어 ↗

    Taobao는 상품 링크의 id= 뒤에 오는 숫자를 상품 ID로 정의하며, SKU는 색상, 사이즈 같은 특정 속성 조합을 나타냅니다. 상품 ID와 SKU를 서로 바꿔 쓰면 안 됩니다.

    2026-09-04 확인