TikTok Search API

TikTok Search

Features

• Keyword video discoveryTurn a topic, brand, product, or event keyword into a candidate video set.
• Relevance and recency sortingSwitch between relevance, date, and likes for topical, recent, or high-like perspectives.
• Publication windowsShape the research period with day, week, month, three_months, or six_months.
• Content and creator fieldsReturn video, creator, engagement, hashtag, and music fields in a consistent search result structure.
• Traceable search snapshotsRecord every search experiment through search_query and collected_at.

Parameters

How to Use

Define the research question first, then choose the keyword, ranking goal, and publication window.

1. Turn the research topic into a specific query and choose results_limit, sort_by, and published_within.
2. POST the request to /v1/tiktok/search and save the returned task_id.
3. Poll /v1/tasks/{task_id} until the task reaches succeeded or failed.
4. Read data.results.items. When has_more is true, continue with next_cursor.

curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Best Use Cases

• Market and category scans: Use product, category, and use-case terms to map the TikTok content landscape and creator sample.
• Event momentum tracking: Combine date with a day or week window to follow recent content around launches, events, and news moments.
• High-like creative research: Order by likes and study recurring hooks, captions, music choices, and hashtag combinations.
• Brand mention monitoring: Run brand and product queries on a schedule and save snapshots for content and communications teams.

Pro Tips

• Split a broad topic into brand, need, occasion, and trend queries, then merge the resulting video sets.
• Choose relevance to map a topic, date to track new publishing, and likes to study popular creative patterns.
• Use published_within to keep samples on a consistent time scale, such as week for recurring reports.
• Store query, sort_by, published_within, and collected_at together so the search can be reproduced.
• Deduplicate across queries by video id and retain every search_query that matched the video.
• Repeat core queries on a schedule to compare shifts in creators, themes, and engagement.

Related APIs