Body parameters
- type
string- required
true- description
Keyword search query.
- type
string- required
false- default
"youtube"- values
youtubetiktokinstagram- description
- Every video result's url is accepted by the transcript and batch endpoints as-is.
- The
type,upload_date,duration,sortandcaptionsoptions search YouTube only.
- type
string- required
false- default
"video"- values
videochannelplaylist- scope
- YouTube only
- description
- Channels come back as
data.kindchannel_list, each row's url accepted by thechannelendpoint; playlists asdata.kindplaylist_list, each row's url accepted by theplaylistendpoint. - A
channelrow carries the @handle, subscriber count and description; itsvideoCountisnull, because YouTube'schannelresults no longer show one.
- Channels come back as
- type
string- required
false- values
hourtodayweekmonthyear- scope
- YouTube video search only
- description
Keep videos uploaded within the last
hour,today, thisweek, thismonthor thisyear.
- type
string- required
false- values
shortmediumlong- scope
- YouTube video search only
- description
Keep
short(under 4 minutes),medium(4 to 20 minutes) orlong(over 20 minutes) videos.
- type
string- required
false- default
"relevance"- values
relevanceviews- scope
- YouTube only
- description
- Result order:
relevance(the default) orviews(most viewed first). - YouTube search no longer sorts by upload date or rating, so neither is offered; for recent videos, filter with
upload_date.
- Result order:
- type
boolean- required
false- default
false- scope
- YouTube video search only
- description
truekeeps only videos with subtitles or closed captions, whose transcripts come from captions rather than AI Fallback Transcription.- Defaults to
false: no filter.
- type
boolean | { mode, timestamps, markdown, chunks }- required
false- description
- Beta.
- Video searches only.
- Adds a
transcriptto every video row, in the same shape as a batch entry (outcome ok, processing or error, with text, segments, and markdown or chunks when asked), so one call goes from aqueryto what the videos say. truefetches caption transcripts with timestamps; an object sets mode ("captions", the default, so a search never starts paid AI transcription unless you send"auto"), timestamps (falsedrops segments), markdown and chunks (see the transcript endpoint).limitcan be at most 10 with it.- Costs the page's credit plus 1 credit per caption transcript delivered; failures are free, and an account that cannot cover the page and every row is refused up front.
- type
integer (1–50)- required
false- default
5- description
Max items to return per page: videos, or the playlists or channels some listing options return.
- type
string- required
false- description
- Opaque pagination cursor from a previous response's
next_cursor(max 256 characters). - Omit for the first page.
- Cursors are scoped to the listing that issued them, so send the same platform and listing options with each page.
- Offset-based sources cannot page past the first 2000 items.
- Opaque pagination cursor from a previous response's
Success
{
"ok": true,
"request_id": "req_…",
"data": {
"kind": "video_list",
"source": "search",
"platform": "instagram",
"videos": [
{
"videoId": "DWI8rZ9iTeD",
"url": "https://www.instagram.com/reel/DWI8rZ9iTeD/",
"title": "Why Transformer Works Only in AC? ⚡\nA transformer is one of the most important devices in electrical systems—but have you ever wondered why it works only with AC (Alternating Current) and not DC (Dire",
"duration": 5,
"channel": "scie.ncebysumati",
"publishedAt": "2026-03-21T08:29:30Z",
"stats": {
"plays": 11559
}
},
{
"videoId": "DVHOMxGiRBb",
"url": "https://www.instagram.com/reel/DVHOMxGiRBb/",
"title": "There is more than one type of transformer! Let’s go over them. #electrician #transformer #electrical.",
"duration": 35,
"channel": "greatdane_homeservices",
"publishedAt": "2026-02-23T19:52:44Z",
"stats": {
"plays": 1370
}
}
],
"next_cursor": "eyJvIjoxMH0"
},
"usage": {
"credits_spent": 1,
"balance": 656,
"bytes": 0
}
}Every Instagram endpoint
- POSTTranscriptText or segments for an Instagram Reel.
- POSTSearchFind Reels by keyword.
- POSTProfile ReelsList an account's Reels, newest first.
- POSTProfile MonitorNew Reels from an account, by webhook.
Same call, other platforms:YouTube Search APITikTok Search API
Frequently asked questions
How do I search Instagram instead of YouTube?
Send platform instagram in the body. Without it the search runs on YouTube. query, limit and cursor work the same on every platform.
Does Instagram search need a Graph API token?
No. It is TranscriptFetch's own endpoint: your TranscriptFetch API key, one page per credit, no Meta app, review or business account.
Can I filter Instagram results by date or duration?
No. Those filters are YouTube-only. Each row carries duration, publishedAt and stats.plays, so filter on your side after the fetch.
How do I get the transcripts of the Reels a search returns?
Send the rows' urls to the batch endpoint. Instagram has no caption track, so each Reel goes to AI Fallback Transcription, billed on delivery at its rate; a short Reel is one credit.