GET
/tiktok/search/keywordSearch TikTok by Keyword
Search TikTok videos by keyword and optionally limit results by duration. Returns normalized metadata and engagement stats.
Quick Start
cURL
curl "https://app.creatorcrawl.com/api/tiktok/search/keyword?query=ai%20tutorial&max_duration_seconds=60" \
-H "x-api-key: YOUR_API_KEY"Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Required | Search keyword or phrase |
max_duration_seconds | number | Optional | Maximum video duration in seconds |
cursor | string | Optional | Pagination cursor |
Response
JSON Response
{
"data": [
{
"id": "7345678901234567890",
"text": "Build an AI agent in 45 seconds",
"duration_seconds": 45,
"view_count": 2500000,
"like_count": 145000,
"platform": "tiktok"
}
],
"meta": {
"platform": "tiktok",
"page": {
"cursor": "10",
"has_more": true
}
}
}Every request costs 1 credit. Response data is live -- never cached.
Use Cases
Content discovery
Find relevant videos on any topic for research, curation, or competitive analysis.
Trend monitoring
Track what content is being created around specific keywords in real time.
Ad research
Analyze organic content around your target keywords before running paid campaigns.
Code Examples
Python
import requests
resp = requests.get(
"https://app.creatorcrawl.com/api/tiktok/search/keyword",
params={"query": "ai tutorial", "max_duration_seconds": 60},
headers={"x-api-key": "YOUR_API_KEY"},
)
for video in resp.json()["data"]:
print(f"{video['text'][:60]} - {video['view_count']} views")JavaScript
const resp = await fetch(
"https://app.creatorcrawl.com/api/tiktok/search/keyword?query=ai%20tutorial&max_duration_seconds=60",
{ headers: { "x-api-key": "YOUR_API_KEY" } }
)
const { data } = await resp.json()
data.forEach(v => console.log(`${v.text.slice(0, 60)} - ${v.view_count} views`))