TikTok Search Scraper API
Our TikTok search scraper takes a keyword and returns the matching public videos as JSON: description, author, play, like, comment and share counts, cover image, and permalink, from a single request.
Use it for
Trend discovery
Creator sourcing
Competitor tracking
Content research
Quickstart
curl "https://api.tiktokscraperapi.com/api/v1/tiktok/search?q=nasa&api_key=$API_KEY"import requests, os
BASE = "https://api.tiktokscraperapi.com"
API_KEY = os.environ["API_KEY"]
data = requests.get(
f"{BASE}/api/v1/tiktok/search",
params={"q": "nasa", "api_key": API_KEY},
timeout=30,
).json()
for row in data["results"]:
print(row)Response
{
"query": "nasa",
"results": [
{
"id": "7301234567890123456",
"desc": "Launch day recap",
"author": {
"username": "nasa"
},
"stats": {
"playCount": 1830000,
"diggCount": 214000,
"commentCount": 3100,
"shareCount": 8800
},
"cover": "https://p16-sign.tiktokcdn.com/abc.jpg",
"url": "https://www.tiktok.com/@nasa/video/7301234567890123456",
"create_time": 1712345678
}
]
}| Field | Type | Description |
|---|---|---|
query | string | The keyword you passed as q. |
results | array | Matching public videos. |
id | string | The video id, the stable identifier in the permalink. |
desc | string | The video description or caption. |
author.username | string | The posting account handle. |
stats | object | playCount, diggCount, commentCount, and shareCount. |
cover | string | URL of the video cover image. |
url | string | The canonical video permalink. |
create_time | integer | Unix timestamp of when the video was posted. |
How it works
- Send a GET with your keyword as q and your API key.
- We route through residential proxies, handle anti-bot, and parse the public results.
- You get validated JSON back, ready to use.
How it compares
| Our API | DIY (requests / headless) | Official TikTok API | |
|---|---|---|---|
| Keyword input | Yes, one q parameter | Manual fetch and parse | Research API is application-gated |
| Per-video stats | play, like, comment, share | Extra parsing per video | Limited to approved research use |
| Setup | API key only | Residential proxies, headless browser, parsers | Application, approval, quotas |
| Login and cookies | None, logged-out only | You manage sessions | Approved credentials required |
Pricing
| Plan | Price | Best for |
|---|---|---|
| Free | 1,000 requests | Testing and small jobs |
| Pro | $0.60 / 1k | Production workloads |
| Pay-as-you-go | $0.90 / 1k | Spiky or one-off volume |
Median response 2.6s. You only pay for successful requests.
FAQ
What is a TikTok search scraper?
It reads TikTok public keyword search results and returns them in a structured format. Our API takes a keyword in the q parameter and returns the matching public videos as JSON, each with a description, author, play and like counts, cover image, and permalink.
What data comes back per video?
Each result carries the video id, description, author username, a stats object with playCount, diggCount, commentCount and shareCount, the cover image URL, the permalink, and the post timestamp.
Can I search hashtags?
Pass the hashtag text as q. The keyword search returns videos that surface for that term. A dedicated hashtag object listing is a separate feature and is not part of this endpoint.
How many videos per call?
One call returns the first public page of results for the keyword. Page through with follow-up calls using the returned cursor when present.
How fast is the API?
Median end-to-end response is about 2.6 seconds, including residential routing, anti-bot handling, retries, and parsing.