JD.com 전체 SKU 및 가격 API

POST

API 상태

24시간 상태: 100%
24시간 평균 소요 시간: 19.03 s

양호 / 정상
사용 가능
제한적
대부분 작동 중단

양호

최근 24시간

최근 30일

item_id에 SKU 중 하나를 넣어 JD.com 상품의 모든 SKU를 나열합니다. 색상, 크기, 용량별로 한 행씩 가격, 재고 상태, 구매 수량 제한을 가져옵니다. 첫 번째 행은 요청한 SKU입니다. price는 로그인하지 않은 구매자가 결제 쿠폰 적용 전에 보는 가격입니다.

요금은 요청 1,000개당 $1.39(호출당 $0.001389)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 요청한 행 1개가 호출 1건으로 계산됩니다. limit 값만큼 먼저 과금되며, 반환되지 않은 행은 환불됩니다. 동기 방식만 지원합니다. 반환되는 모든 데이터(배치의 모든 대상 또는 상품의 모든 SKU)를 이 호출 안에서 읽어 오며, "mode": "async"를 지정하면 과금 전에 422를 반환합니다.

AI 프롬프트

EveryInfra JD.com 전체 SKU 및 가격 엔드포인트(jd/skus)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 jd, action은 skus로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
  - item_id: skus에 사용할 JD.com 상품 1개를 SKU 중 하나로 지정합니다. 숫자 문자열, JD 상품 링크(https://item.jd.com/<digits>.html, https://item.m.jd.com/product/<digits>.html 또는 WeChat 안에서 연 wqitem.jd.com 페이지) 또는 이런 링크가 정확히 1개 포함된 공유 텍스트를 전달해야 합니다.
- 선택 파라미터:
  - limit: 이 호출에서 반환할 최대 행 수로, 1~100 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다. (기본값: 100)
- 레코드 목록을 반환합니다. 각 레코드의 주요 필드: item_id (JD 숫자 상품 ID입니다), url, product_id (상품의 모든 SKU가 공유하는 JD 상품 그룹 ID입니다(skus)), is_requested (이 행이 요청에서 지정한 SKU인지 여부입니다(skus)), title, properties (이 SKU의 판매 속성으로, 속성 이름 → 값 형태이며 JD 표기 그대…), color (JD 페이지에 표시된 이 SKU의 색상(또는 마감)입니다), size (JD 페이지에 표시된 이 SKU의 사이즈, 용량 또는 규격 값입니다), price, currency, on_sale (이 SKU가 판매 등록되어 있는지 여부입니다(skus)), in_stock (이 SKU를 즉시 배송으로 주문할 수 있는지 여부입니다(skus)); 전체 필드 28개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- 요청 본문 예시:
{
  "platform": "jd",
  "action": "skus",
  "params": {
    "item_id": "https://item.m.jd.com/product/10232789210191.html"
  }
}
- 요금: 요청 1,000개당 $1.39. 실패하거나 빈 결과에는 과금하지 않습니다.
- 이 엔드포인트는 동기 방식으로만 동작하므로 요청 본문에 "mode": "async"를 추가하지 마세요.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

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

요청 파라미터

이름	위치	타입	필수	기본값	설명
`Authorization`	header	`string`	예	-	Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
`platform`	body	`string`	예	`jd`	플랫폼 식별자이며 고정값입니다.
`action`	body	`string`	예	`skus`	기능 식별자이며 고정값입니다.
`item_id`	body.params	`string`	예	-	`skus`에 사용할 JD.com 상품 1개를 SKU 중 하나로 지정합니다. 숫자 문자열, JD 상품 링크(`https://item.jd.com/<digits>.html`, `https://item.m.jd.com/product/<digits>.html` 또는 WeChat 안에서 연 `wqitem.jd.com` 페이지) 또는 이런 링크가 정확히 1개 포함된 공유 텍스트를 전달해야 합니다. 링크의 추적 파라미터는 상관없습니다. `3.cn`, `u.jd.com` 같은 단축 링크는 사용할 수 없으므로, 먼저 브라우저에서 열고 상품 페이지 링크를 복사해야 합니다.
`limit`	body.params	`integer (1–100)`	아니요	`100`	이 호출에서 반환할 최대 행 수로, 1~100 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다.

코드 샘플

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": "jd",
  "action": "skus",
  "params": {
    "item_id": "https://item.m.jd.com/product/10232789210191.html"
  }
}'

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

응답 예시

실제 응답

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

json

{
  "id": "req_…",
  "platform": "jd",
  "action": "skus",
  "results": [
    {
      "item_id": "10232789210191",
      "url": "https://item.jd.com/10232789210191.html",
      "product_id": "10035827040758",
      "is_requested": true,
      "title": "HUAWEI Pura X View 华为阔直屏手机 沉浸阔直板 超轻薄长续航 亚麻灰 12GB+512GB",
      "properties": {
        "外观": "亚麻灰",
        "存储容量": "12GB+512GB"
      },
      "color": "亚麻灰",
      "size": "12GB+512GB",
      "price": 6999,
      "currency": "CNY",
      "on_sale": true,
      "in_stock": false,
      "stock_state": "pre_order",
      "stock": 6,
      "purchase_limit": 2,
      "delivery_promise": "预计11月23日前发货",
      "is_presale": false,
      "is_government_subsidy": false,
      "upc": "•••",
      "brand": "华为",
      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/536837/15/12542/70661/6ad028daF0fe35216/00835a05a00b835a.jpg",
      "shop_id": "16374386",
      "shop_name": "华为官方旗舰店",
      "is_jd_self": false,
      "variant_count": 12,
      "platform": "jd"
    },
    {
      "item_id": "10232789210185",
      "url": "https://item.jd.com/10232789210185.html",
      "product_id": "10035827040758",
      "is_requested": false,
      "title": "HUAWEI Pura X View 华为阔直屏手机 沉浸阔直板 超轻薄长续航 零度白 12GB+512GB",
      "properties": {
        "外观": "零度白",
        "存储容量": "12GB+512GB"
      },
      "color": "零度白",
      "size": "12GB+512GB",
      "price": 6999,
      "currency": "CNY",
      "on_sale": true,
      "in_stock": false,
      "stock_state": "pre_order",
      "stock": 6,
      "purchase_limit": 2,
      "delivery_promise": "预计11月23日前发货",
      "is_presale": false,
      "is_government_subsidy": false,
      "upc": "•••",
      "brand": "华为",
      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/547139/32/2822/66014/6ad028e0F5afed3f9/00835a05a054f860.jpg",
      "shop_id": "16374386",
      "shop_name": "华为官方旗舰店",
      "is_jd_self": false,
      "variant_count": 12,
      "platform": "jd"
    }
  ],
  "count": 12,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

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

필드	의미
`item_id`	JD 숫자 상품 ID입니다. 검색 결과에서 얻은 값을 상세, 리뷰, 가격 호출에 바로 전달할 수 있습니다.
`url`	플랫폼에서 해당 레코드로 연결되는 링크입니다.
`product_id`	상품의 모든 SKU가 공유하는 JD 상품 그룹 ID입니다(skus). SKU가 아니므로 상세, 리뷰, 가격 호출에 item_id로 전달하지 마세요.
`is_requested`	이 행이 요청에서 지정한 SKU인지 여부입니다(skus). 상품의 다른 SKU는 false입니다.
`title`	제목입니다. 플랫폼에 제목이 없으면 null입니다(예: 텍스트 전용 게시물).
`properties`	이 SKU의 판매 속성으로, 속성 이름 → 값 형태이며 JD 표기 그대로라 보통 중국어입니다(예: 해당 SKU의 색상과 저장 용량)(skus).
`color`	JD 페이지에 표시된 이 SKU의 색상(또는 마감)입니다.
`size`	JD 페이지에 표시된 이 SKU의 사이즈, 용량 또는 규격 값입니다.
`price`	통화 기호 없이 숫자로 표시한 가격입니다. currency를 참고하세요.
`currency`	가격의 통화 코드입니다(예: CNY, USD). price는 있는데 currency가 null이면 통화를 추정하지 마세요.
`on_sale`	이 SKU가 판매 등록되어 있는지 여부입니다(skus). 판매 등록이 재고 있음을 뜻하지는 않으므로, 재고는 in_stock과 stock_state를 확인하세요.
`in_stock`	이 SKU를 즉시 배송으로 주문할 수 있는지 여부입니다(skus). 예약 판매 및 사전 예약 SKU는 false이며, stock_state를 참고하세요.
`stock_state`	공개된 JD 재고 상태 코드입니다.
`stock`	JD가 공개적으로 표시한 재고 수량입니다. null은 0이 아니라 페이지에 값이 없었음을 의미합니다.
`purchase_limit`	구매자당 최대 구매 수량입니다. null은 페이지에 제한이 명시되지 않았음을 의미합니다(skus).
`delivery_promise`	JD 표기 그대로의 배송 또는 발송 예정 안내입니다(skus). 예를 들어 예상 발송 기한이 포함될 수 있습니다. 로그아웃 상태에서는 JD의 기본 지역을 기준으로 제공되며, 지역에 따라 다를 수 있습니다.
`is_presale`	상품이 예약 판매 중인지 여부입니다(skus).
`is_government_subsidy`	JD가 이 SKU에 국가 보조금 대상 표시를 했는지 여부입니다(skus). 이 표시만으로는 가격에 보조금이 이미 반영되었는지 알 수 없습니다. null은 이번에 표시 정보를 가져오지 못했음을 의미합니다.
`is_billion_subsidy`	JD가 이 SKU를 Billion Subsidy 프로그램 대상으로 표시했는지 여부입니다(skus). null은 이번에 표시 정보를 가져오지 못했음을 의미합니다.
`is_flash_sale`	이 SKU가 타임 세일 중인지 여부입니다(skus). null은 이번에 표시 정보를 가져오지 못했음을 의미합니다.
`promo_tags`	JD가 이 SKU에 표시하는 프로모션 라벨로, JD 표기 그대로입니다(skus). 없거나 가져오지 못하면 null입니다.
`upc`	상품 바코드(UPC/EAN)입니다. 페이지에 없으면 null입니다.
`brand`	상품 브랜드입니다.
`image_url`	이미지 URL입니다. search, product_detail, shop, skus에서는 상품의 메인(커버) 이미지이고, description_images에서는 해당 행의 설명 이미지(JD 이미지 호스트의 원본 크기 https 이미지)입니다.
`shop_id`	JD 숫자 상점 ID입니다.
`shop_name`	공개된 상점 이름입니다.
`is_jd_self`	JD 직영(JD.com 리테일) 상품인지 여부입니다.
`variant_count`	옵션(SKU) 수입니다. 옵션이 없거나 제공되지 않으면 null입니다. 모든 skus 행에 같은 값이 들어 있으며, 반환된 행 수보다 크면 limit으로 인해 목록이 잘렸거나 이번에 일부 SKU를 가져오지 못한 것입니다.
`platform`	출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).

오류 및 과금

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

오류

공식 참고 자료

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

JD.com: 표시 가격 라벨과 조건부 구매 가격 ↗
JD.com은 실시간 표시 라벨을 최종 상품 가격 및 회원, 신규 사용자, 지역, 대상자별 혜택과 구분하며, 일부 비교 정보는 지연되거나 불완전할 수 있다고 안내합니다. 반환된 가격은 요청 시점에 보이는 스냅샷으로 취급해야 하며, 개인별 거래 가격, 결제 금액, 정확성 보장으로 간주해서는 안 됩니다.
2026-09-11 확인