TikTok Shop Search Suggestions
TikTok Shop 검색 추천어는 쇼핑객이 입력하는 동안 상점 검색창이 제안하는 자동완성으로, 각각 완성된 키워드 문구, 목록 내 순위, 추천된 시장 정보를 갖고 있습니다. 사람들이 실제로 검색하는 내용에서 나온 문구이므로 상품명, 광고, 콘텐츠에서 겨냥할 상품 변형, 호환 모델, 구매 관점을 드러내 줍니다.
TikTok Shop Search Suggestions API 주요 기능
- 검색어 앞부분에 대한 자동완성query 값에 phone case처럼 검색의 첫 단어를 넣으면, 각 행에 phone cases 17 pro max처럼 쇼핑객이 이어서 완성하는 더 긴 문구가 반환됩니다.
- TikTok Shop 자체의 추천 순서rank 값은 TikTok Shop이 보여 주는 순서대로 추천어에 1부터 번호를 매기며, 검색어 하나당 최대 20개입니다.
- 시장별 추천어region 값으로 US, SG, MY, PH, TH, VN, ID, JP, MX 중 하나를 고르며(기본값 US), 모든 행에 query와 region 값이 함께 담겨 결과의 출처를 추적할 수 있습니다.
TikTok Shop Search Suggestions API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 자동완성할 쇼핑 검색어의 앞부분으로, phone case 같은 값입니다. |
region | 선택 | 검색 시장으로 US, SG, MY, PH, TH, VN, ID, JP, MX 중 하나이며 기본값은 US입니다. |
TikTok Shop Search Suggestions API 사용 방법
쇼핑 검색어의 첫 단어를 보내고 자동완성을 순위대로 읽습니다.
- {"query": "phone case", "region": "US"}을 /v1/tiktok-shop/search-suggestions로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 keyword와 rank 값을 읽고, has_more 값이 true이면 results.next_cursor로 나머지를 가져옵니다.
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"}'TikTok Shop Search Suggestions API 추천 활용 사례
- 상품명 키워드 선정: 모델, 사이즈, 변형을 담은 keyword 문구를 골라 상품명과 상품 설명에 반영합니다.
- 광고·콘텐츠용 키워드 세트 구성: 여러 시드 검색어의 keyword 열을 모아 광고, 동영상 캡션, 콘텐츠 기획에 쓸 키워드 목록을 만듭니다.
- 추천어 변화 추적: 같은 query와 region 값으로 주기적으로 다시 실행하고 keyword별 rank 값을 비교해 어떤 문구가 오르고 내리거나 새로 등장하는지 확인합니다.
- 시장별 검색 완성 방식 비교: 같은 검색어를 여러 region에 보내고 keyword 목록을 나란히 놓아, 시장마다 쇼핑객이 같은 단어를 어떻게 이어 완성하는지 봅니다.
TikTok Shop Search Suggestions API 활용 팁
- 추천어는 검색어의 앞부분을 늘려 가는 방식이라 긴 문구로는 완성할 여지가 적으므로, 완전한 문구보다 짧은 어간으로 시작하세요.
- 반환된 keyword 값을 새 query로 다시 보내면 한 단계 더 깊이 들어가, 시드 하나가 더 긴 문구의 트리로 확장됩니다.
- 관련된 어간끼리는 같은 문구를 반환할 수 있으므로, 여러 시드의 결과는 행 id이기도 한 keyword 값으로 중복을 제거하세요.
- 유망한 keyword 값은 같은 region 값과 함께 TikTok Shop Search에 넘겨 그 추천어 뒤에 있는 상품을 확인하세요.
관련 API
TikTok Shop Search Suggestions API 외에 TikTok Shop의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Shop Search API — 키워드와 시장 지역으로 공개 TikTok Shop 상품을 검색하며, 판매자, 가격, 미디어, 평점, 리뷰, 판매량 필드를 포함합니다.
- TikTok Shop Products API — TikTok Shop 스토어 URL 하나에서 공개 상품을 수집하며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
- TikTok Shop Product API — PDP URL로 공개 TikTok Shop 상품 하나를 가져오며, 판매자, 가격, 미디어, 카테고리, SKU, 평점, 리뷰, 판매량 필드를 포함합니다.
- TikTok Shop Product Reviews API — TikTok Shop PDP URL 하나의 공개 리뷰를 수집하며, 본문, 평점, 리뷰어, 이미지, SKU, 국가, 구매 맥락 필드를 포함합니다.
- TikTok Shop Hot Products API — 지역 코드로 TikTok Shop 시장의 인기 판매 상품을 순위대로 수집하며 가격, 통화, 판매량, 평점, 판매자를 포함합니다.
- TikTok Shop Categories API — TikTok Shop 시장의 전체 카테고리 트리를 카테고리 ID, 이름, 영문 slug, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.