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 Products | ID, JP, MX, MY, PH, SG, TH, VN | 없음, 필수 |
| Categories, Category Products, Search Suggestions | US, SG, MY, PH, TH, VN, ID, JP, MX | US |
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에 넣어 각 검색어에서 어떤 상품이 상위에 오르는지 확인하세요.
호출 세 번으로 카테고리 훑기
한 시장을 대상으로 한 일반적인 리서치 흐름은 다음과 같습니다.
- 시장마다 Categories를 한 번 호출하고 트리를 저장합니다(0.5크레딧).
- 관심 있는 최하위 카테고리(
is_leaf: true)를 골라 각각 Category Products를 호출합니다. - 각 카테고리의 핵심 상품 단어로 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 살펴보기