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 AI 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.
// Twitter — text post
{
"status": "completed",
"type": "twitter",
"result": {
"metadata": {
"source": "twitter", "url": "https://x.com/elonmusk/status/...",
"author": "elonmusk",
"description": "Happy New Year! 2026 will be a banger",
"likes": 855179, "views": 74630618, "comments": 36580
},
"about": "Happy New Year! 2026 will be a banger",
"creditCost": 1.5
}
}
// TikTok — video with AI analysis
{
"status": "completed",
"type": "tiktok",
"result": {
"metadata": {
"source": "tiktok", "url": "https://tiktok.com/@zachking/video/...",
"title": "They rejected my Hogwarts application but I found a way...",
"author": "Zach King",
"thumbnail": "https://...",
"duration": 18, // seconds
"likes": 27904390, "views": 2367412175, "comments": 714924
},
"transcript": "Like my costume? Yeah, well that's so cool...",
"about": "A person dressed as Harry Potter pretends to fly on a broomstick...",
"creditCost": 2
}
}

Response fields

metadata
objectNormalized fields for the source. Always includes source and url. See per-source breakdown below.
transcript
string?Verbatim spoken words. Present when speech is detected (YouTube, TikTok, Instagram reels).
about
string?For video/image: AI-generated visual description optimised for RAG. For Twitter: the tweet text. For Reddit: post title/body.
creditCost
numberCredits charged for this job. Fixed 1.5 for text-only extractions; billed per actual AI tokens for analyze jobs.
raw
objectFull unmodified provider response. Contains all source-specific fields beyond the normalized metadata.

Metadata by source

// Twitter / X
{
"source": "twitter", "url": "https://x.com/...",
"author": "elonmusk",
"description": "tweet text here",
"likes": 855179, "views": 74630618, "comments": 36580
}
// Reddit
{
"source": "reddit", "url": "https://reddit.com/r/...",
"title": "Finland to audit whether US is delivering NATO weapons",
"author": "jackytheblade",
"thumbnail": "https://...", // optional
"likes": 24247, "comments": 675
}
// TikTok
{
"source": "tiktok", "url": "https://tiktok.com/@...",
"title": "video caption / hashtags",
"author": "Zach King",
"thumbnail": "https://...",
"duration": 18, // seconds
"likes": 27904390, "views": 2367412175, "comments": 714924
}
// Instagram
{
"source": "instagram", "url": "https://instagram.com/reel/...",
"author": "brezscales",
"thumbnail": "https://...", // optional
"duration": 32.866, // seconds, reels only
"description": "post caption", // optional
"views": 18810 // optional
}
// YouTube — transcript in result.transcript; metadata is minimal
{
"source": "youtube", "url": "https://youtube.com/watch?v=..."
}

Supported sources

YouTubeYouTubetranscript · about (analyze:true) · creditCost 1.5
TikTokTikToktranscript · about · title, author, thumbnail, duration, likes, views, comments
InstagramInstagramtranscript · about · author, thumbnail, duration, description, views
X / TwitterX / Twitterabout (tweet text) · author, description, likes, views, comments
RedditRedditabout (post text) · title, author, thumbnail, likes, comments

Credits

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

YouTube transcriptmetadata + transcript
1.5 credits
YouTube (analyze: true)AI visual analysis
~1 credit / 15 sec
Tweet or Reddit posttext + metadata
1.5 credits
Reddit (analyze: true) + videoAI video analysis
~1 credit / 15 sec
Reddit (analyze: true) + imageAI image analysis
~1 credit / image
Twitter (analyze: true) + videoAI video analysis
~1 credit / 15 sec
Twitter (analyze: true) + imageAI image analysis
~1 credit / image
TikTok videoAI visual analysis, always on
~1 credit / 15 sec
Instagram reelAI visual analysis, always on
~1 credit / 15 sec
Instagram photo / carouselAI visual analysis, always on
~1 credit / image