API Reference

One endpoint. Submit a URL, get back a job ID, poll for the result. All requests require an API key.

Base URLhttps://api.anydata.lol

Authentication

Pass your API key in the Authorization header as a Bearer token.

curl https://api.anydata.lol/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d "{"url":"https://youtube.com/watch?v=..."} "

POST /extract

Submit a URL for extraction. Returns a job ID immediately — credits are reserved at this point.

POST/extract
url
stringThe URL to extract. Source type (YouTube, TikTok, etc.) is auto-detected.
analyze
booleanOptional. Default false. When true, uses Gemini to analyze media and return a rich about + transcript. Required for YouTube/Twitter visual analysis. TikTok and Instagram always analyze regardless of this flag.
// Request
{
"url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
"analyze": true // optional — enables visual analysis
}
// 202 Accepted
{
"jobId": "abc123",
"status": "pending"
}

GET /jobs/:id

Poll to check job status. Jobs expire after 5 minutes. Recommended interval: 1–2s.

GET/jobs/:id
pending
statusJob queued, not yet started.
processing
statusExtraction in progress.
completed
statusResult is ready in the result field.
failed
statusExtraction failed. See the error field.
GET /jobs/abc123
{
"status": "completed",
"type": "youtube",
"result": {
"metadata": { ... },
"transcript": "We're no strangers to love...",
"about": "Rick Astley's iconic 1987 pop hit."
}
}

Response fields

metadata
objectSource-specific fields — title, author, duration, view count, etc.
transcript
stringVerbatim spoken words. Empty string if no speech detected.
about
stringShort summary if transcript exists. Rich visual description if no speech — optimised for RAG and semantic search.

Supported sources

YouTubeYouTubetranscript, metadata (title, author, thumbnail)
TikTokTikToktranscript, about, metadata (author, stats, cover)
InstagramInstagramtranscript, about, metadata (author, caption, stats)
X / TwitterX / Twittertext, author, stats (likes, views, retweets)
RedditReddittitle, body, author, score, comment count

Credits

Credits are deducted per extraction. TikTok and Instagram always include visual analysis. YouTube and Twitter require analyze: true for Gemini analysis.

YouTubemetadata + transcript
1.5 credits
YouTube (analyze: true)Gemini visual analysis, billed per actual tokens
token-based
Tweet or Reddit posttext + metadata
1.5 credits
Reddit (analyze: true) + mediaGemini image/video analysis, billed per actual tokens
token-based
Twitter (analyze: true) + mediaGemini image/video analysis, billed per actual tokens
token-based
TikTok videoalways Gemini — billed per actual tokens
token-based
Instagram reelalways Gemini — billed per actual tokens
token-based
Instagram image/carouselalways Gemini — billed per actual tokens
token-based