tiktok-shop/
search-suggestions

선택한 시장에서 쇼핑 검색어 앞부분에 대해 TikTok Shop이 제안하는 자동완성을 가져오며, 1위부터 순위가 매겨진 키워드 문구를 최대 20개까지 원래 검색어, 지역과 함께 반환합니다.

TikTok Shop Search Suggestions API

검색어 앞부분 입력
최대 20개 자동완성
1위부터 순위
요청당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

쇼핑 검색어의 첫 단어를 보내고 자동완성을 순위대로 읽습니다.

  1. {"query": "phone case", "region": "US"}을 /v1/tiktok-shop/search-suggestions로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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에 넘겨 그 추천어 뒤에 있는 상품을 확인하세요.

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, 레벨, 상위 카테고리, 경로와 함께 가져옵니다.

다른 플랫폼 둘러보기

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

TikTok Shop Search Suggestions API — 자주 묻는 질문

TikTok Shop Search Suggestions API는 한 시장에서 쇼핑 검색어 앞부분에 대해 TikTok Shop이 제안하는 자동완성을 가져오는 프로그래밍 인터페이스입니다. 추천 키워드 문구를 최대 20개까지 순위, 원래 검색어, 지역과 함께 반환합니다.

요청마다 query 값은 하나입니다. 시드 키워드가 여러 개라면 시드마다 요청을 하나씩 제출하고 keyword 값으로 결과를 합치세요.

호출 한 번에 0.5 크레딧이며 추천어를 최대 20개까지 반환합니다. 요금은 추천어 개수가 아니라 호출 단위로 청구됩니다.