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

JD.com 리뷰 API

POST

API 상태

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

JD.com 상품의 구매자 리뷰를 최대 10개 조회합니다. 평점, 추가 리뷰, 구매한 옵션, 도움이 됨 투표 수, 사진, 리뷰 작성자의 PLUS 회원 여부와 구매 횟수를 가져옵니다. 닉네임은 JD에 표시된 그대로이며 일부 가려져 있을 수 있습니다. 가져온 리뷰는 전체 기록이 아니며 재게시가 허용된 것도 아닙니다.

JD.com 리뷰 기능은 item_id로 상품 하나의 공개 리뷰를 읽어옵니다. 각 행에는 리뷰 내용, 구매자가 나중에 추가한 리뷰, 평점, 게시 시간, 구매한 색상과 사이즈, 리뷰어 닉네임, PLUS 회원 여부, 구매 횟수가 담깁니다. 구매자의 목소리를 파악할 때 사용하며, 평판 분석, 원인별 불만 분류, 경쟁 상품과의 세부 비교에 활용할 수 있습니다.

review_append에는 구매자가 첫 리뷰 이후에 올린 추가 리뷰가 담깁니다. 추가 리뷰는 첫인상보다 내구성과 사후 서비스를 더 잘 보여 주는 경우가 많으므로 따로 분석하십시오. 닉네임은 JD에 표시된 그대로 반환되며 일부가 가려져 있을 수 있고, 개인을 식별할 수 없습니다. 평점을 비교하기 전에 같은 행의 rating_scale을 확인하십시오.

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

AI 프롬프트

EveryInfra JD.com 리뷰 엔드포인트(jd/reviews)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 jd, action은 reviews로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
  - item_id: product_detail, reviews, product_price에서 JD.com 상품 하나를 지정합니다. search가 반환한 숫자 문자열 또는 쿼리나 프래그먼트가 없는 정식 레거시 URL https://item.jd.com/<digits>.html을 전달합니다. 임의의 URL, 불투명한 URL, 다른 호스트의 URL은 동일한 상품 식별자로 인정되지 않습니다.
- 선택 파라미터:
  - limit: 이 호출에서 반환할 최대 행 수로, 1~10 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다. (기본값: 10)
- 레코드 목록을 반환합니다. 각 레코드의 주요 필드: id, item_id (JD 숫자 상품 ID입니다), text, review_append (구매자가 덧붙인 추가 리뷰 텍스트입니다), rating, rating_scale, posted_at, color (JD 페이지에 표시된 이 SKU의 색상(또는 마감)입니다), size (JD 페이지에 표시된 이 SKU의 사이즈, 용량 또는 규격 값입니다), useful_count, images, author_name (JD에 표시된 그대로 반환되는 리뷰 작성자 닉네임입니다(JD가 이미 일…); 전체 필드 15개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- 요청 본문 예시:
{
  "platform": "jd",
  "action": "reviews",
  "params": {
    "item_id": "100012043978"
  }
}
- 요금: 요청 1,000개당 $1.39. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "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예jd플랫폼 식별자이며 고정값입니다.
actionbodystring예reviews기능 식별자이며 고정값입니다.
item_idbody.paramsstring예-product_detail, reviews, product_price에서 JD.com 상품 하나를 지정합니다. search가 반환한 숫자 문자열 또는 쿼리나 프래그먼트가 없는 정식 레거시 URL https://item.jd.com/<digits>.html을 전달합니다. 임의의 URL, 불투명한 URL, 다른 호스트의 URL은 동일한 상품 식별자로 인정되지 않습니다.
limitbody.paramsinteger (1–10)아니요10이 호출에서 반환할 최대 행 수로, 1~10 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 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": "reviews",
  "params": {
    "item_id": "100012043978"
  }
}'

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

응답 예시

필드 미리보기

이 파라미터에 대한 샘플 응답이 아직 없습니다. 이 미리보기는 API 정의에 따른 응답 형태와 필드를 보여 주며, …는 자리표시자입니다. 실제 호출 결과가 아닙니다.

json
{
  "id": "req_…",
  "platform": "jd",
  "action": "reviews",
  "results": [
    {
      "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": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

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

필드의미
id플랫폼에서 레코드의 고유 ID입니다. 한 플랫폼 안에서만 고유하며, 플랫폼이 다르면 ID가 중복될 수 있습니다.
item_idJD 숫자 상품 ID입니다. 검색 결과에서 얻은 값을 상세, 리뷰, 가격 호출에 바로 전달할 수 있습니다.
textHTML을 제거한 본문으로, 잘리지 않고 전체가 반환됩니다(일부 플랫폼은 목록 결과 자체에 발췌문만 포함되며, 이 경우 해당 플랫폼의 필드 설명에 명시되어 있습니다).
review_append구매자가 덧붙인 추가 리뷰 텍스트입니다.
rating평점입니다. 척도는 플랫폼마다 다릅니다. 같은 행의 rating_scale이 최댓값을 나타냅니다(보통 5이며, Booking, Douban, iQIYI, NAVER는 10). 플랫폼 간에 비교하기 전에 rating_scale로 환산하세요. 그렇지 않으면 비교 결과가 뒤바뀔 수 있습니다.
rating_scale같은 행에 있는 rating의 최댓값입니다. 5점 척도는 5, 10점 척도는 10입니다. 행에 rating이 있을 때만 포함됩니다.
posted_at게시 시각으로, ISO 8601 UTC 형식입니다(예: 2026-08-07T12:34:56+00:00). 플랫폼에서 받은 비표준 문자열은 그대로 전달되므로 방어적으로 파싱하세요. null이면 플랫폼이 공개하지 않은 것입니다.
colorJD 페이지에 표시된 이 SKU의 색상(또는 마감)입니다.
sizeJD 페이지에 표시된 이 SKU의 사이즈, 용량 또는 규격 값입니다.
useful_count플랫폼 자체의 의미를 따름
images플랫폼 표시 순서대로 나열된 이미지 링크 배열입니다. 이미지가 없으면 필드가 생략됩니다.
author_nameJD에 표시된 그대로 반환되는 리뷰 작성자 닉네임입니다(JD가 이미 일부를 가렸을 수 있음).
author_avatar_url리뷰 작성자 아바타 URL입니다.
author_is_plus리뷰 작성자가 JD PLUS 회원인지 여부입니다.
buy_count리뷰 작성자가 이 상품을 구매한 횟수로, 페이지 표시('N회 구매') 그대로입니다.
platform출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).

FAQ

추가 리뷰는 어디에 유용한가요?

review_append는 구매자가 첫 리뷰 이후, 대개 상품을 한동안 사용한 뒤에 덧붙인 내용으로 내구성, 결함, 사후 서비스 등을 다룹니다. 첫 리뷰와 따로 분석하면 단기 만족도와 장기 만족도를 구분할 수 있습니다.

각 리뷰어에 대해 어떤 정보를 알 수 있나요?

페이지에 공개적으로 표시되는 정보, 즉 닉네임, 프로필 이미지, PLUS 회원 여부, 해당 상품 구매 횟수입니다. JD가 닉네임 일부를 가릴 수 있습니다. 이 정보는 구매자 구성을 이해하는 데 사용하고, 개인을 식별하는 데 사용하지 마십시오.

item_id는 어디서 얻나요?

가장 쉬운 방법은 JD 검색 결과의 item_id를 사용하는 것입니다. 숫자 상품 ID나 쿼리 문자열이 없는 https://item.jd.com/<number>.html도 사용할 수 있으며, 어느 쪽이든 같은 상품을 대상으로 호출됩니다.

오류 및 과금

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

오류

공식 참고 자료

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

  • JD.com: 리뷰 및 사진 리뷰 작성 규칙 ↗

    JD.com은 리뷰, 추가 리뷰, 이미지, 답글, 검수, 접힌 콘텐츠, 마스킹된 닉네임을 구분합니다. 공개 여부는 리뷰 규칙과 개인정보 보호 규칙에 따라 달라질 수 있으므로, 반환된 결과를 전체 리뷰 기록이나 리뷰 작성자 콘텐츠의 재배포 허가로 설명해서는 안 됩니다.

    2026-09-11 확인

  • JD.com 사용자 서비스 약관(2026년 1월 20일 시행): 공개 리뷰와 접근 범위 ↗

    JD.com 사용자 서비스 약관에 따르면 리뷰 정보는 공개되며 JD.com은 약관에 따라 이를 사용할 수 있습니다. 또한 개인정보는 원칙적으로 동의 없이 제3자에게 공개되지 않으며, 개인정보 도용이나 적법한 권리 침해를 금지합니다. 이는 접근 및 허가 범위의 근거일 뿐이며, EveryInfra나 호출자에게 텍스트, 이미지, 사용자 정보를 재배포하거나 학습에 사용하거나 상업적으로 재사용할 권리를 부여하지 않습니다.

    2026-09-11 확인