Products

TikTok keyword opportunities: search terms with search volume, plus product and category leads

Changed on

TikTok's Product Opportunities for one shop, collected daily: KEYWORD leads are search terms buyers use (query_words, search_volume), PRODUCT and CATEGORY leads are products and categories TikTok says are in demand. Market metrics are TikTok's display buckets (est_market_gmv 10k+) with a parsed lower bound (*_min). Sorted by search volume. The newest collection per type by default; start_date/end_date (at most 30 days) read every day in the range, one row per opportunity with days_seen.

runs says what the collector has for each type — ok, partial (TikTok had more than was paged through), collected_empty, failed or not_collected — with latest_attempt_outcome for the newest attempt, so an empty data list always comes with its reason. Only the newest successful collection's rows are returned. Single-shop only. Returns 503 while the keyword tables are unavailable.

post/product-insights/opportunities

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/product-insights/opportunities
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Request body

opportunity_type'KEYWORD' | 'PRODUCT' | 'CATEGORY' nullable

KEYWORD (search terms with search volume), PRODUCT or CATEGORY leads; every type when omitted.

start_datestring date nullable

With end_date, read every day in the range instead of the newest snapshot.

end_datestring date nullable
limitinteger

Opportunities per page.

pageinteger

1-based page.

Response

Successful Response

shop_idinteger required
mode'latest' | 'range' required
start_datestring nullable
end_datestring nullable

Changes