TikTok Video Screen Text API
Scrape TikTok Video Screen Text data with one API call. Extracts the text shown ON the video itself — the overlay captions creators put on screen, which the regular caption and transcript never carry. Two layers are merged: native text-sticker data (present when the creator used TikTok's built-in text tool) and AI OCR of the video's cover frame, which also catches text burned in with editors like CapCut that no data provider returns. `texts` is the deduplicated union in reading order; `native_texts` and `ocr_texts` expose each layer separately and `source` says which layers produced data. A video with no on-screen text returns an empty `texts` array (that is a real answer, not an error). Costs 5 credits; auto-refunds when the video lookup or the whole extraction fails.
Last updated August 2026Maintained by the SocialCrawl team
Returns the text shown on the video itself: native text stickers plus AI OCR of the cover frame, so burned-in editor captions are caught too.
Use it for the on-screen overlay text; the caption lives on post and the spoken words on post/transcript.
Searching 46 platforms in parallel
What can you do with the Video Screen Text API?
The Video Screen Text endpoint gives you structured TikTok data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktok/video/screen-text?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7499229683859426602"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/tiktok/video/screen-text",
params={
'url': 'https://www.tiktok.com/@stoolpresidente/video/7499229683859426602',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/tiktok/video/screen-text?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7499229683859426602",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| url | Yes | Full URL of the TikTok video |
What does the TikTok Video Screen Text API return?
This example shows the endpoint's response shape and fields. Values are illustrative; this is not a live capture.
Example response
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/video/screen-text",
"data": {
"video_id": "7660536627479022870",
"url": "https://www.tiktok.com/@disneymusic/video/7660536627479022870",
"texts": [
"Enjoy 57 minutes of Nostalgic \nDISNEY Songs"
],
"native_texts": [
"Enjoy 57 minutes of Nostalgic \nDISNEY Songs"
],
"ocr_texts": [
"Enjoy 57 minutes of Nostalgic DISNEY Songs"
],
"source": "native+ocr",
"frame": "cover"
},
"credits_used": 5,
"credits_remaining": 95,
"request_id": "req-a1b2c3d4e5f6",
"cached": false
}Illustrative fixture for the documented response shape. Values are examples, not a production capture.
How does the TikTok Video Screen Text API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 46 platforms covering 10B+ monthly active users.
One schema, every platform
Query 46 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape TikTok Video Screen Text data?
Get your API key and start pulling TikTok data in under 60 seconds.
