TikTok Shop상품 리서치이커머스검색 추천어API 가이드

TikTok Shop 상품 리서치 API: 인기 상품, 카테고리, 검색 추천어

SocQ의 신규 TikTok Shop 엔드포인트 4종은 시장별 인기 판매 상품, 전체 카테고리 트리, 카테고리별 상품, 쇼핑객이 보는 검색 자동완성을 반환합니다.

SocQ2026년 11월 19일 업데이트약 7분 소요

TikTok Shop 상품 리서치는 세 가지 질문에서 출발합니다. 한 시장에서 무엇이 팔리는가, 카테고리 안에는 무엇이 있는가, 쇼핑객은 검색할 때 무엇을 입력하는가입니다. SocQ는 이미 상품 검색, 스토어 카탈로그, 상품 페이지, 리뷰, 크리에이터 쇼케이스를 제공하고 있었으며, 이들은 TikTok Shop API와 스크래퍼 베스트 7에서 비교합니다. 2026-11-17에는 이 세 가지 질문에 직접 답하는 엔드포인트 4개가 TikTok Shop 플랫폼 페이지에 추가되었습니다.

이 가이드에서는 엔드포인트별 반환 데이터, 요청 형식, 가격, 그리고 이들을 연결해 카테고리를 훑는 방법을 다룹니다.

빠른 답변: POST https://api.socq.ai/v1/tiktok-shop/<endpoint>로 JSON 본문을 보내세요. 반환된 task_id를 저장하고 status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 다음 data.results.items를 읽습니다.

새로운 TikTok Shop 엔드포인트

SocQ 1크레딧 = $0.005.

엔드포인트반환 데이터가격
TikTok Shop Hot Products API시장의 인기 판매 상품을 TikTok Shop 순서대로, 가격, 판매량, 평점, 상점과 함께 반환상품당 0.5크레딧($0.0025)
TikTok Shop Categories API시장의 전체 카테고리 트리. 카테고리마다 ID, 레벨, 상위 카테고리를 담은 한 행호출당 0.5크레딧($0.0025)
TikTok Shop Category Products API카테고리 하나의 상품과 가격, 판매량, 평점, 리뷰, 상점상품당 0.5크레딧($0.0025)
TikTok Shop Search Suggestions API검색어 앞부분에 대한 자동완성 최대 20개, 순위 포함호출당 0.5크레딧($0.0025)

지원 시장

엔드포인트region 값기본값
Hot ProductsID, JP, MX, MY, PH, SG, TH, VN없음, 필수
Categories, Category Products, Search SuggestionsUS, SG, MY, PH, TH, VN, ID, JP, MXUS

Hot Products에는 US가 없습니다. 미국 상품 리서치에는 Categories와 Category Products를 사용하세요.

인증과 비동기 작업 흐름

모든 요청은 API 키로 인증합니다. 제출, 작업 상태, 결과 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 호출은 data.task_id와 data.status를 즉시 반환합니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded이면 응답에 result_count, credits_amount, 그리고 data.results.items에 정규화된 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500까지 지정할 수 있습니다. results.has_more가 true이면 results.next_cursor를 cursor로 넘겨 다음 페이지를 읽습니다. 실패한 작업에는 error_message가 담깁니다.

각 엔드포인트는 선택 항목인 callback_url도 받습니다. 작업이 끝나면 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 작업 엔드포인트에서 읽습니다. 클라이언트 쪽 타임아웃은 작업을 취소하지 않으므로 다시 제출하지 말고 같은 작업 ID로 조회를 이어가세요. 402는 계정의 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

Hot Products: 한 시장에서 무엇이 팔리는가

Hot Products API는 시장의 인기 판매 상품을 TikTok Shop이 매긴 순위대로 반환합니다. 각 상품에는 제목, price(금액, 통화, 서식이 적용된 문자열), sold_count, rating, reviews_count, seller, 이미지와 상품 페이지 url이 들어 있습니다. region은 필수입니다. results_limit의 기본값은 50이며 1부터 200까지 받습니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "MY", "results_limit": 50}'

사용 시점: 시장별로 매주 스냅샷을 찍어 급부상하는 상품을 찾거나, 가격을 벤치마킹하거나, 소싱·홍보할 상품을 고를 때. 가격은 말레이시아의 MYR처럼 현지 통화로 반환되므로 시장을 비교하기 전에 환산하세요.

Categories: 전체 카테고리 트리

Categories API는 한 번의 호출로 시장의 모든 카테고리를 반환합니다. 각 행에는 카테고리 id, name, 영문 slug, level, parent_id, is_leaf, path(상위 카테고리 이름), cover_url, region이 있습니다. 최상위 카테고리는 parent_id: null과 level: 1을 가지므로, 계층을 트리로 다시 구성하거나 평면 조회 테이블로 유지할 수 있습니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "US"}'

사용 시점: 시장마다 한 번 호출하고 결과를 캐시하세요. Category Products에 ID가 필요하고, 트리는 TikTok Shop 카테고리를 자체 카탈로그에 매핑할 때 유용합니다.

Category Products: 쇼핑객처럼 카테고리 둘러보기

Category Products API는 Categories API에서 얻은 숫자 category_id를 받아, 해당 카테고리의 상품을 제목, 가격, 판매량, 평점, 리뷰, 상점, 이미지와 함께 반환합니다. region의 기본값은 US입니다. results_limit의 기본값은 30이며 1부터 500까지 받습니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id": "601450", "region": "US", "results_limit": 30}'

사용 시점: 하위 카테고리 간 가격대를 비교하거나, 카테고리의 베스트셀러가 시간에 따라 어떻게 바뀌는지 지켜볼 때.

Search Suggestions: 쇼핑객이 입력하는 검색어

Search Suggestions API는 쇼핑 검색어의 앞부분을 query로 받아, TikTok Shop이 제안하는 순서대로 1위부터 순위가 매겨진 자동완성을 최대 20개 반환합니다. 각 행에는 keyword, 보낸 query, rank, region이 있습니다. region의 기본값은 US입니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "phone case", "region": "US"}'

사용 시점: 상품 등록, 광고, 콘텐츠를 위한 키워드 리서치. 문서 예시에서 phone case의 첫 번째 자동완성은 phone cases 17 pro max로, 쇼핑객이 어떤 기기 모델용으로 구매하는지 보여 줍니다. 자동완성 결과를 TikTok Shop Search에 넣어 각 검색어에서 어떤 상품이 상위에 오르는지 확인하세요.

호출 세 번으로 카테고리 훑기

한 시장을 대상으로 한 일반적인 리서치 흐름은 다음과 같습니다.

  1. 시장마다 Categories를 한 번 호출하고 트리를 저장합니다(0.5크레딧).
  2. 관심 있는 최하위 카테고리(is_leaf: true)를 골라 각각 Category Products를 호출합니다.
  3. 각 카테고리의 핵심 상품 단어로 Search Suggestions를 호출해 쇼핑객이 검색어를 어떻게 표현하는지 확인합니다.

카테고리 10개에서 30개씩 가져오면 상품 300개, 즉 150크레딧입니다. 트리(0.5)와 추천어 호출 10회(5)를 더하면 155.5크레딧, 약 $0.78입니다. Hot Products가 지원하는 시장이라면 상품 50개 스냅샷에 25크레딧($0.125)이 추가됩니다.

필드를 주의해서 읽기

상품 행은 세 상품 엔드포인트에서 같은 정규화 구조를 사용합니다. 다른 SocQ 필드와 마찬가지로 소스가 제공하지 않는 값은 0이 아니라 null입니다. 문서 예시에서는 표시된 상품의 rating, reviews_count, sold_count가 null이므로, 이 값들로 상품 순위를 매기기 전에 누락된 판매량이나 평점은 0이 아니라 알 수 없는 값으로 처리하세요.

상품 하나를 더 깊이 살펴보려면 해당 url을 현재 미국 지역만 지원하는 TikTok Shop Product API와 Product Reviews API에 넘기세요. TikTok Shop 데이터를 얻는 다른 방법은 TikTok Shop API 대안을 참고하세요. LIVE 방송 중 판매되는 상품은 TikTok 신규 엔드포인트 가이드의 TikTok Live Shopping API에서 다룹니다.

자주 묻는 질문(FAQ)

TikTok Shop 판매자 계정이나 파트너 계정이 필요한가요?

아니요. 이 엔드포인트들은 공개 TikTok Shop 데이터를 읽으며, SocQ API 키로 인증합니다.

Hot Products는 왜 US를 거부하나요?

US는 이 엔드포인트의 region 값에 포함되지 않습니다. Hot Products는 ID, JP, MX, MY, PH, SG, TH, VN을 지원합니다. 나머지 세 엔드포인트는 US를 지원하며 기본값으로 사용합니다.

카테고리 ID는 어디에서 얻나요?

Categories API에서 얻습니다. 같은 region에서 각 행의 id가 Category Products가 받는 category_id입니다.

엔드포인트별 과금 방식은 어떻게 되나요?

Categories와 Search Suggestions는 반환하는 행 수와 관계없이 호출당 0.5크레딧입니다. Hot Products와 Category Products는 반환된 상품당 0.5크레딧입니다.

검색어 하나에 추천어가 몇 개 반환되나요?

최대 20개이며, TikTok Shop 순서대로 1위부터 순위가 매겨집니다.

TIKTOK SHOP API

공개 TikTok Shop URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

TikTok Shop API 살펴보기