tiktok-shop/
product

PDP URL로 TikTok Shop 공개 상품을 조회하고, 상품 정보, 판매자, 가격, 공개된 평점과 판매 수, 미디어, 카테고리, SKU를 하나의 정규화된 레코드로 반환합니다.

TikTok Shop Product API

공개 상품 상세
PDP URL 입력
단일 정규화 레코드
결과당 0.7 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

TikTok Shop Product

TikTok Shop 상품은 상품 정보, 판매자, 가격, 미디어, 카테고리, 옵션, 평점, 리뷰 수, 판매 수 신호를 담은 공개 상품 상세 페이지입니다. 이러한 필드는 상품 정보 보강, 카탈로그 조사, 머천다이징 검토, 특정 시점 비교에 활용할 수 있습니다.

TikTok Shop Product API 주요 기능

  • PDP 상세 단건 조회지원되는 TikTok Shop 공개 PDP URL 하나를 제출하면 정규화된 상품 레코드를 최대 하나 받습니다. 상품을 탐색하는 용도가 아니라 알고 있는 상품의 정보를 보강하는 데 적합합니다.
  • 판매자, 가격, 공개된 커머스 신호상품 레코드는 노출된 판매자 정보, 판매가와 정가, 통화, 할인, 평점, 리뷰 수, 판매 수를 보존하므로 필드 단위로 바로 평가할 수 있습니다.
  • 미디어, 카테고리, SKU 맥락반환되는 레코드에는 공개 상품 페이지에서 노출된 상품 이미지(크기 포함)와 카테고리, SKU 또는 옵션 구조가 포함됩니다.

TikTok Shop Product API 매개변수

매개변수필수설명
url필수/shop/pdp/{numeric_id} 또는 /shop/pdp/{slug}/{numeric_id} 형식과 일치하는 TikTok Shop 공개 URL로, 필수 값입니다. 작업 하나에 상품 하나만 받습니다.
region선택TikTok Shop 시장 지역으로, 선택 값입니다. 기본값은 US이며, 그 밖에 허용되는 지역에서는 상품 제공 여부가 다를 수 있습니다.

TikTok Shop Product API 사용 방법

지원되는 상품 URL을 제출하고, 비동기 작업 ID를 저장한 뒤, 작업이 성공하면 정규화된 상품을 읽습니다.

  1. 지원되는 PDP url 하나와 선택 사항인 region을 담아 /v1/tiktok-shop/product로 POST 요청을 보냅니다.
  2. 반환된 task_id를 저장하고, 상태가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 성공하면 data.results.items를 읽고, has_more가 true일 때만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

TikTok Shop Product API 추천 활용 사례

  • 검색·카탈로그 결과 정보 보강: 알고 있는 PDP URL로, 선택한 검색 결과나 스토어 카탈로그 상품에 판매자, 가격, 평점, 미디어, 카테고리, SKU 필드를 추가합니다.
  • 상품 신호 스냅샷 비교: 특정 시점의 상품 레코드들에서 수집한 판매가, 정가, 할인, 평점, 리뷰 수, 판매 수를 비교합니다.
  • 카테고리 및 옵션 검토: 노출된 카테고리, 이미지, SKU 구조를 살펴, 공개 상품이 어떻게 구성되고 노출되는지 검토합니다.

TikTok Shop Product API 활용 팁

  • 요청이 거부되지 않도록, 제출하기 전에 입력값이 숫자 상품 ID가 포함된 tiktok.com의 전체 PDP URL인지 검증하세요.
  • 상품이 다른 허용 시장에 속하지 않는 한 region은 US로 유지하고, US가 아닌 지역에서 결과가 비어 있으면 상품 제공 범위의 한계일 수 있다고 보세요.
  • results_limit은 보내지 마세요. 작업 하나는 상품 URL 하나만 받으며, 정규화된 레코드를 최대 하나만 반환합니다.
  • null 허용인 판매자, 가격, 신호, 미디어, 카테고리, SKU 필드는 공개 페이지의 스냅샷으로 취급하고, 성공한 작업에 항목이 없을 때는 임의의 상품을 만들지 말고 그대로 처리하세요.

TikTok Shop Product API 외에 TikTok Shop의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • TikTok Shop Search API — 키워드와 시장 지역으로 공개 TikTok Shop 상품을 검색하며, 판매자, 가격, 미디어, 평점, 리뷰, 판매량 필드를 포함합니다.
  • TikTok Shop Products API — TikTok Shop 스토어 URL 하나에서 공개 상품을 수집하며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
  • TikTok Shop Product Reviews API — TikTok Shop PDP URL 하나의 공개 리뷰를 수집하며, 본문, 평점, 리뷰어, 이미지, SKU, 국가, 구매 맥락 필드를 포함합니다.
  • TikTok Shop User Showcase API — TikTok 사용자 이름 하나의 공개 쇼케이스 상품을 수집하며, 가격, 판매자, 미디어, 평점, 리뷰, 판매량, 지역 맥락을 포함합니다.
  • TikTok Shop Hot Products API — 지역 코드로 TikTok Shop 시장의 인기 판매 상품을 순위대로 수집하며 가격, 통화, 판매량, 평점, 판매자를 포함합니다.
  • TikTok Shop Categories API — TikTok Shop 시장의 전체 카테고리 트리를 카테고리 ID, 이름, 영문 slug, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.

다른 플랫폼 둘러보기

TikTok Shop 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Shop Product API — 자주 묻는 질문

TikTok Shop Product API는 지원되는 TikTok Shop PDP URL에서 공개 상품 하나를 가져옵니다. 정규화된 상품 정보, 판매자, 가격, 평점, 리뷰·판매 수 신호, 미디어, 카테고리, SKU 데이터를 반환합니다.

경로가 /shop/pdp/{numeric_id} 또는 /shop/pdp/{slug}/{numeric_id}와 일치하는 tiktok.com 또는 TikTok 서브도메인 URL을 사용합니다. 그 밖의 TikTok URL은 잘못된 입력으로 거부됩니다.

아니요. 작업 하나는 상품 URL 하나만 받고, results_limit을 받지 않으며, 정규화된 상품 레코드를 최대 하나만 반환합니다.

region의 기본값은 US이며 US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE를 받습니다. US 외 지역의 상품 제공 여부는 다를 수 있습니다.

유효한 PDP URL이라도 상품이 삭제되었거나, 선택한 지역에서 이용할 수 없거나, 공개 페이지에 노출되지 않으면 레코드가 없을 수 있습니다.

반환된 상품 레코드 1개당 0.7 SocQ 크레딧이 차감됩니다. 상품이 반환되지 않은 작업에는 결과 요금이 부과되지 않습니다.