플랫폼 가용성
- 24시간 상태
- 100%
최근 30일
제공 기능
각 JD.com 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 검색어로 JD.com 상품을 조회해 최대 5개 결과를 가져옵니다. | 요청 1,000개당 $2.47 | 정상 |
상품 상세 정보product_detail | item_id 하나로 JD.com 상품의 전체 레코드를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | JD.com 상품의 구매자 리뷰를 최대 10개 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
숍shop | JD.com 스토어 하나의 상품을 최대 24개 탐색하며, 상품별 상품 ID, 제목, 가격, 통화, 구매 가능 여부를 포함합니다. | 요청 1,000개당 $28.81 | 정상 |
상품 가격product_price | item_id로 JD.com 상품 하나의 현재 표시 가격과 구매 가능 여부를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
전체 SKU 및 가격skus | item_id에 SKU 중 하나를 넣어 JD.com 상품의 모든 SKU를 나열합니다. | 요청 1,000개당 $1.39행 1개당 호출 1회로 계산 | 양호 · 상태 100% |
상세 설명 이미지description_images | JD.com 상품 상세 설명 영역의 모든 이미지를 위에서 아래 순서로 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
JD.com 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 검색어로 JD.com 상품을 조회해 최대 5개 결과를 가져옵니다. 결과별로 표시된 가격, 판매량 및 리뷰 수치, 긍정 평가 비율, 스토어, 프로모션 태그가 포함됩니다. 반환된 | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=5, maxLimit=5. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $2.47 | item_id · url · title · short_title · price · currency · sold_count · review_count · good_rate · shop_id · shop_name · shop_url · is_jd_self · promotion · sell_point · category_ids · image_url · platform |
product_detail상품 상세 정보
| item_id | — | Sync 응답 | — | 요청 1,000개당 $1.39 | item_id · url · title · price · price_display · price_masked · currency · available · unavailable_reason · shop_id · shop_name · shop_url · category_id · category · stock · stock_state · color · size · weight · image_url · image_urls · is_jd_self · brand · model · original_price · upc · warranty · product_area · is_jd_express · variant_count · variants · platform |
reviews리뷰 JD.com 상품의 구매자 리뷰를 최대 10개 조회합니다. 평점, 추가 리뷰, 구매한 옵션, 도움이 됨 투표 수, 사진, 리뷰 작성자의 PLUS 회원 여부와 구매 횟수를 가져옵니다. 닉네임은 JD에 표시된 그대로이며 일부 가려져 있을 수 있습니다. 가져온 리뷰는 전체 기록이 아니며 재게시가 허용된 것도 아닙니다. | item_id | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=10. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · item_id · text · review_append · rating · rating_scale · posted_at · color · size · useful_count · images · author_name · author_avatar_url · author_is_plus · buy_count · platform |
shop숍 JD.com 스토어 하나의 상품을 최대 24개 탐색하며, 상품별 상품 ID, 제목, 가격, 통화, 구매 가능 여부를 포함합니다. 스토어의 숫자 | shop_id | — | Sync 응답 | 카탈로그 값: defaultLimit=24, maxLimit=24. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $28.81 | item_id · url · title · price · currency · shop_id · shop_name · shop_url · image_url · available · platform |
product_price상품 가격
| item_id | — | Sync 응답 | — | 요청 1,000개당 $1.39 | item_id · url · price · currency · available · unavailable_reason · platform |
skus전체 SKU 및 가격
| item_id | — | Sync 응답 | 카탈로그 값: defaultLimit=100, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39행 1개당 호출 1회로 계산 | item_id · url · product_id · is_requested · title · properties · color · size · price · currency · on_sale · in_stock · stock_state · stock · purchase_limit · delivery_promise · is_presale · is_government_subsidy · is_billion_subsidy · is_flash_sale · promo_tags · upc · brand · image_url · shop_id · shop_name · is_jd_self · variant_count · platform |
description_images상세 설명 이미지 JD.com 상품 상세 설명 영역의 모든 이미지를 위에서 아래 순서로 가져옵니다. 각 원본 크기 링크에는 | item_id | — | Sync 응답 | — | 요청 1,000개당 $1.39 | item_id · position · image_url · image_count · platform |
JD.com search 파라미터는 각각 무엇을 의미하나요?
검색어로 JD.com 상품을 조회해 최대 5개 결과를 가져옵니다. 결과별로 표시된 가격, 판매량 및 리뷰 수치, 긍정 평가 비율, 스토어, 프로모션 태그가 포함됩니다. 반환된 item_id를 상세, 리뷰, 가격 액션에 전달하세요. 순서와 범위는 해당 응답 하나에만 해당하며 전체 카탈로그를 대표하지 않습니다.
keyword필수- JD.com
search에 사용할 검색어를 지정합니다. 상품 ID나 상점 선택자가 아닌 검색 문구여야 하며, 일치하는 결과가 카탈로그 전체를 포괄한다는 의미는 아닙니다.JD.com JOS와 JD Union: 상품 및 SKU 객체 — JD.com의 공식 오픈 플랫폼 및 제휴 자료는 상품명, 대표 이미지, 카테고리, 표시 가격, 물류, 직영 여부, 주문량 지표 등 상품 및 SKU 객체를 설명합니다. 이 용어 설명이 모든 웹페이지나 필드를 이용할 수 있다거나, 호출자에게 접근 권한이 있다거나, EveryInfra가 공식 인터페이스를 구현했다는 증거가 되지는 않습니다. · 확인일
JD.com product_detail 파라미터는 각각 무엇을 의미하나요?
item_id 하나로 JD.com 상품의 전체 레코드를 가져옵니다. 브랜드, 모델, 가격과 원래 가격, 재고 상태, 옵션, 바코드, 보증, JD Logistics 여부가 포함됩니다. price_masked가 true이면 표시 가격이 정확하지 않습니다. 재고가 null이면 0이 아니라 표시되지 않았다는 뜻입니다.
item_id필수product_detail,reviews,product_price에서 JD.com 상품 하나를 지정합니다.search가 반환한 숫자 문자열 또는 쿼리나 프래그먼트가 없는 정식 레거시 URLhttps://item.jd.com/<digits>.html을 전달합니다. 임의의 URL, 불투명한 URL, 다른 호스트의 URL은 동일한 상품 식별자로 인정되지 않습니다.JD.com: 표시 가격 라벨과 조건부 구매 가격 — JD.com은 실시간 표시 라벨을 최종 상품 가격 및 회원, 신규 사용자, 지역, 대상자별 혜택과 구분하며, 일부 비교 정보는 지연되거나 불완전할 수 있다고 안내합니다. 반환된 가격은 요청 시점에 보이는 스냅샷으로 취급해야 하며, 개인별 거래 가격, 결제 금액, 정확성 보장으로 간주해서는 안 됩니다. · 확인일
JD.com reviews 파라미터는 각각 무엇을 의미하나요?
JD.com 상품의 구매자 리뷰를 최대 10개 조회합니다. 평점, 추가 리뷰, 구매한 옵션, 도움이 됨 투표 수, 사진, 리뷰 작성자의 PLUS 회원 여부와 구매 횟수를 가져옵니다. 닉네임은 JD에 표시된 그대로이며 일부 가려져 있을 수 있습니다. 가져온 리뷰는 전체 기록이 아니며 재게시가 허용된 것도 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태item_id필수product_detail,reviews,product_price에서 JD.com 상품 하나를 지정합니다.search가 반환한 숫자 문자열 또는 쿼리나 프래그먼트가 없는 정식 레거시 URLhttps://item.jd.com/<digits>.html을 전달합니다. 임의의 URL, 불투명한 URL, 다른 호스트의 URL은 동일한 상품 식별자로 인정되지 않습니다.JD.com: 리뷰 및 사진 리뷰 작성 규칙 — JD.com은 리뷰, 추가 리뷰, 이미지, 답글, 검수, 접힌 콘텐츠, 마스킹된 닉네임을 구분합니다. 공개 여부는 리뷰 규칙과 개인정보 보호 규칙에 따라 달라질 수 있으므로, 반환된 결과를 전체 리뷰 기록이나 리뷰 작성자 콘텐츠의 재배포 허가로 설명해서는 안 됩니다. · 확인일JD.com 사용자 서비스 약관(2026년 1월 20일 시행): 공개 리뷰와 접근 범위 — JD.com 사용자 서비스 약관에 따르면 리뷰 정보는 공개되며 JD.com은 약관에 따라 이를 사용할 수 있습니다. 또한 개인정보는 원칙적으로 동의 없이 제3자에게 공개되지 않으며, 개인정보 도용이나 적법한 권리 침해를 금지합니다. 이는 접근 및 허가 범위의 근거일 뿐이며, EveryInfra나 호출자에게 텍스트, 이미지, 사용자 정보를 재배포하거나 학습에 사용하거나 상업적으로 재사용할 권리를 부여하지 않습니다. · 확인일
JD.com shop 파라미터는 각각 무엇을 의미하나요?
JD.com 스토어 하나의 상품을 최대 24개 탐색하며, 상품별 상품 ID, 제목, 가격, 통화, 구매 가능 여부를 포함합니다. 스토어의 숫자 shop_id나 mall.jd.com 링크를 전달하세요. 결과가 스토어의 전체 재고를 입증하지는 않습니다.
shop_id필수shop액션에서 사용할 상점을 지정합니다. 숫자 문자열 또는 쿼리나 프래그먼트가 없는 정식 레거시 URLhttps://mall.jd.com/index-<digits>.html을 전달합니다. 다른 호스트의 URL은 거부되며, 이 선택자는 상품item_id를 받지 않습니다.JD.com JSSDK: SKU와 매장 대상은 별도로 지정한다 — JD.com 리디렉션 문서는 상품 상세 대상에는 `skuId`를, 매장 상세 대상에는 `shopId`를 사용합니다. 이는 상품 식별자와 매장 식별자를 구분해야 한다는 근거가 되지만, 웹페이지 수집 권한, URL 파싱 지원, 매장 전체 카탈로그, EveryInfra의 요청 동작을 입증하지는 않습니다. · 확인일
JD.com product_price 파라미터는 각각 무엇을 의미하나요?
item_id로 JD.com 상품 하나의 현재 표시 가격과 구매 가능 여부를 확인합니다. 구매할 수 없는 상품이면 명시된 사유를 제공합니다. 특정 시점의 값이며 개인별 결제 가격, 회원 할인, 최종 결제 금액이 아닙니다.
item_id필수product_detail,reviews,product_price에서 JD.com 상품 하나를 지정합니다.search가 반환한 숫자 문자열 또는 쿼리나 프래그먼트가 없는 정식 레거시 URLhttps://item.jd.com/<digits>.html을 전달합니다. 임의의 URL, 불투명한 URL, 다른 호스트의 URL은 동일한 상품 식별자로 인정되지 않습니다.JD.com: 표시 가격 라벨과 조건부 구매 가격 — JD.com은 실시간 표시 라벨을 최종 상품 가격 및 회원, 신규 사용자, 지역, 대상자별 혜택과 구분하며, 일부 비교 정보는 지연되거나 불완전할 수 있다고 안내합니다. 반환된 가격은 요청 시점에 보이는 스냅샷으로 취급해야 하며, 개인별 거래 가격, 결제 금액, 정확성 보장으로 간주해서는 안 됩니다. · 확인일
JD.com skus 파라미터는 각각 무엇을 의미하나요?
item_id에 SKU 중 하나를 넣어 JD.com 상품의 모든 SKU를 나열합니다. 색상, 크기, 용량별로 한 행씩 가격, 재고 상태, 구매 수량 제한을 가져옵니다. 첫 번째 행은 요청한 SKU입니다. price는 로그인하지 않은 구매자가 결제 쿠폰 적용 전에 보는 가격입니다.
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개 포함된 공유 텍스트를 전달해야 합니다. 링크의 추적 파라미터는 상관없습니다.3.cn,u.jd.com같은 단축 링크는 사용할 수 없으므로, 먼저 브라우저에서 열고 상품 페이지 링크를 복사해야 합니다.JD.com: 표시 가격 라벨과 조건부 구매 가격 — JD.com은 실시간 표시 라벨을 최종 상품 가격 및 회원, 신규 사용자, 지역, 대상자별 혜택과 구분하며, 일부 비교 정보는 지연되거나 불완전할 수 있다고 안내합니다. 반환된 가격은 요청 시점에 보이는 스냅샷으로 취급해야 하며, 개인별 거래 가격, 결제 금액, 정확성 보장으로 간주해서는 안 됩니다. · 확인일
JD.com description_images 파라미터는 각각 무엇을 의미하나요?
JD.com 상품 상세 설명 영역의 모든 이미지를 위에서 아래 순서로 가져옵니다. 각 원본 크기 링크에는 position으로 번호가 매겨지며, image_count에 총개수가 담깁니다. item_id에 상품의 SKU 중 하나나 상품 링크를 전달하세요. 갤러리 이미지는 product_detail에서 제공됩니다. 상세 설명 이미지가 없는 상품은 빈 결과를 반환하며 과금되지 않습니다.
item_id필수- 설명 이미지를 가져올 JD.com 상품을 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같은 단축 링크는 사용할 수 없으므로, 먼저 브라우저에서 열고 상품 페이지 링크를 복사해야 합니다.
JD.com 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":"jd","action":"search","params":{"keyword":"<keyword>"}}'
JD.com 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기가격 스크래핑의 상업화: 판매자가 구독을 갱신하는 가격 모니터링 제품 만들기
판매자는 왜 가격 모니터링에 돈을 내고, 왜 구독을 해지할까요? 상품 매칭, 예외 목록, 가격 승인 워크플로를 통해 가격 데이터 제공 방식, 과금 단위, 파일럿 인수 기준을 살펴봅니다.
글 읽기API 실패, 크레딧 환불, 대사: 요청 한 건의 순과금액을 감사하는 방법
작업, 호출 시도, 전달 상태, 지갑 이벤트를 분리해 과금 전 거부, 빈 결과, 부분 크레딧 환불을 중복 집계 없이 처리하며, 정수 기반 오프라인 예시를 사용합니다.
글 읽기JD.com API 자주 묻는 질문
JD.com API로 무엇을 가져올 수 있나요?
platform을 jd 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상품 상세 정보, 리뷰, 숍, 상품 가격 및 more입니다. 각 액션 이름은 서로 다른 JD.com 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
JD.com에 공식 API가 있나요?
JD의 오픈 플랫폼(JOS)은 등록된 개발자와 파트너에게 개발자 센터에서 만들고 게시한 앱을 통해 물류, 마케팅, 클라우드, 인증 로그인 기능을 제공합니다. 제휴 파트너를 위한 상품 홍보는 별도의 JD Union 프로그램에서 운영됩니다.
공식 출처: JD Open Platform (JOS) developer center · JD Union · 확인일
JD.com 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. JD.com 개발자 앱을 등록하거나, JD.com API 접근을 신청하거나, JD.com 계정으로 로그인할 필요가 없으며, 액션은 공개된 JD.com 데이터만 반환합니다.
JD.com API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $1.39부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
JD.com search 요청에는 어떤 입력이 필요한가요?
JD.com search에 사용할 검색어를 지정합니다. 상품 ID나 상점 선택자가 아닌 검색 문구여야 하며, 일치하는 결과가 카탈로그 전체를 포괄한다는 의미는 아닙니다. params 안의 keyword 필드로 전달하세요.
JD.com search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 item_id, title, short_title 및 price입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 JD.com 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. skus runs 동기 방식으로만 실행됩니다. 반환하는 모든 데이터를(배치의 모든 대상 또는 상품의 모든 SKU) 같은 호출 안에서 읽어 오기 때문이며, "mode": "async"가 포함된 요청은 과금 전에 422를 받습니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.