scrape — 500 calls per day, shared across all 24 methods. Each method call counts as one request against that limit, regardless of download_media.
download_media — opt-in CDN staging
Every method that returns media URLs accepts an optional download_media: boolean (default false).
false— Response contains raw source CDN URLs (TikTok / IG / X / YT / ad-library hosts). These URLs are often gatekept and can’t be fetched by downstream tools likewatchMedia,transcribeMedia, or external LLM video tools.true— VidJutsu fetches every media URL, stages it to our public CDN, and replaces source URLs with VidJutsu URLs in the response. Use whenever you’ll pipe the media downstream.
Methods
TikTok
| Method | Required | Optional |
|---|---|---|
scrapeTikTokProfile | handle | trim, download_media |
scrapeTikTokProfileVideos | handle | cursor, download_media |
scrapeTikTokVideo | url | trim, download_media |
scrapeTikTokVideoTranscript | url | — |
scrapeTikTokVideoComments | url | cursor |
scrapeTikTokSearchUsers | query | cursor |
scrapeTikTokTrending | — | country, download_media |
| Method | Required | Optional |
|---|---|---|
scrapeInstagramProfile | handle | download_media |
scrapeInstagramUserPosts | handle | cursor, download_media |
scrapeInstagramPost | url | download_media |
scrapeInstagramPostComments | url | cursor |
scrapeInstagramUserReels | handle | cursor, download_media |
X (Twitter)
| Method | Required | Optional |
|---|---|---|
scrapeTwitterProfile | handle | download_media |
scrapeTwitterUserTweets | handle | cursor, trim, download_media |
scrapeTwitterTweet | url | trim, download_media |
scrapeTwitterTweetTranscript | url | — |
YouTube
| Method | Required | Optional |
|---|---|---|
scrapeYouTubeChannel | — | handle, channel_id, download_media |
scrapeYouTubeChannelVideos | — | handle, channel_id, cursor, download_media |
scrapeYouTubeVideo | url | download_media |
scrapeYouTubeVideoComments | url | cursor |
Ad libraries
| Method | Required | Optional |
|---|---|---|
scrapeMetaAds | query | country, download_media |
scrapeGoogleAds | company | download_media |
scrapeLinkedInAds | query | download_media |
scrapeRedditAds | query | download_media |
Example — research a niche end-to-end
Example — competitive ad teardown
Errors
Every method returns the standard VidJutsu envelope:| Code | Meaning |
|---|---|
rate_limit | 500/day shared scrape limit hit |
bad_request | Invalid input (e.g. malformed URL or handle) |
upstream_unavailable | Upstream provider timed out or returned 5xx |
subscription_required | Active subscription required for the scrape rate group |