Video

Each parser reads one kind of page and returns the site’s own data. Send the page’s URL to scrape with a json format that names the parser. The data comes back in data.json.

curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/results?search_query=lofi+beats","formats":[{"type":"json","parser":"youtube-search"}]}'

const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.youtube.com/results?search_query=lofi+beats",
    formats: [{ type: "json", parser: "youtube-search" }],
  }),
});
console.log(await response.json());

import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.youtube.com/results?search_query=lofi+beats",
        "formats": [{"type": "json", "parser": "youtube-search"}],
    },
)
print(response.json())

Send a parser’s options in the same format, like {"type": "json", "parser": "youtube-search", "options": {...}}. See Parsers for how they work.

Parser	Reads	Price
`youtube-search`	A YouTube search results page with the search in search_query.	1 credit per call.
`youtube-video`	A YouTube video link: watch, youtu.be, shorts or live.	1 credit per call.
`youtube-transcript`	A YouTube video link: watch, youtu.be, shorts or live.	1 credit per call.
`youtube-comments`	A YouTube video link: watch, youtu.be, shorts or live.	1 credit per call.
`youtube-channel`	A YouTube channel link: @handle, /channel/, /c/ or /user/, with an optional tab.	1 credit per call.
`youtube-post`	A YouTube community post link: /post/Ugkx…	1 credit per call.
`youtube-playlist`	A YouTube playlist page with list in the link.	1 credit per call.
`tiktok-video`	A TikTok video page or share link.	1 credit per call.
`tiktok-comments`	A TikTok video page or share link.	1 credit per call.
`tiktok-transcript`	A TikTok video page or share link.	1 credit when the video has captions; otherwise 2 credits plus 1 credit for every 10 seconds of audio, up to 3 minutes.
`tiktok-profile`	A TikTok profile page.	1 credit per call.
`tiktok-hashtag`	A TikTok hashtag page.	1 credit per call.
`tiktok-sound`	A TikTok sound page that ends in the sound id.	1 credit per call.
`tiktok-search`	A TikTok user search page (/search/user) or video search page (/search) with a q query.	1 credit per call.
`tiktok-followers`	A TikTok profile page.	1 credit per call.
`tiktok-following`	A TikTok profile page.	1 credit per call.
`instagram-transcript`	An Instagram reel or video post.	1 credit plus 1 credit for every 30 seconds of audio, up to 5 minutes.

youtube-search

A YouTube search results page with the search in search_query.

Example page: https://www.youtube.com/results?search_query=lofi+beats
Returns: A list of videos: results, cursor, page, total.
Options: type (Leave out for videos, channels and playlists. Use shorts for Shorts), duration, uploadDate, features, prioritize, cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call. Works without an API key.

Example response

{
  "results": [
    {
      "id": "RDEMB4pXSfqexQjAYE27XBWebA",
      "url": "https://www.youtube.com/playlist?list=RDEMB4pXSfqexQjAYE27XBWebA",
      "title": "Mix - Lo-Fi Beats",
      "description": null,
      "author": {
        "id": null,
        "name": null,
        "handle": null,
        "url": null,
        "avatarUrl": null
      },
      "publishedAt": null,
      "durationSeconds": null,
      "views": null,
      "likes": null,
      "comments": null,
      "thumbnailUrl": "https://i.ytimg.com/vi/xVf4Zk8CBj0/hq720.jpg?sqp=-oaymwExCNAFEJQDSFryq4qpAyMIARUAAIhCGAHwAQH4Af4JgALQBYoCDAgAEAEYOSBhKG…",
      "hashtags": [],
      "type": "playlist",
      "videoCount": null
    }
  ],
  "cursor": "seen_88e6f353-7668-4a45-be2f-ee006bafacc9",
  "page": null,
  "total": null
}

youtube-video

A YouTube video link: watch, youtu.be, shorts or live.

Example page: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Returns: One video: id, url, title, description, author, publishedAt, durationSeconds, views, likes, comments, thumbnailUrl, hashtags.
Price: 1 credit per call. Works without an API key.

Example response

{
  "id": "dQw4w9WgXcQ",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this…",
  "author": {
    "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "name": "Rick Astley",
    "handle": "RickAstleyYT",
    "url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
    "avatarUrl": null
  },
  "publishedAt": "2009-10-25T06:57:33.000Z",
  "durationSeconds": 213,
  "views": 1833745427,
  "likes": 19491332,
  "comments": 2400000,
  "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
  "hashtags": [],
  "isShort": false,
  "isLive": false,
  "category": "Music",
  "tags": [
    "rick astley",
    "Never Gonna Give You Up",
    "nggyu"
  ],
  "channelSubscribers": 4560000,
  "chapters": [],
  "mostReplayedAtSeconds": [
    2
  ]
}

youtube-transcript

A YouTube video link: watch, youtu.be, shorts or live.

Example page: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Returns: startSeconds, endSeconds, text.
Options: language (BCP 47 language tag, e.g. en or pt-BR. Any case is accepted), includeTimestamps.
Price: 1 credit per call. Works without an API key.

Example response

{
  "videoId": "dQw4w9WgXcQ",
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "language": "en",
  "isAutoGenerated": false,
  "durationSeconds": 213,
  "text": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules and so do I ♪ ♪ A full commitment's what I'm thinking of ♪ ♪…"
}

youtube-comments

A YouTube video link: watch, youtu.be, shorts or live.

Example page: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Returns: A list of comments: results, cursor, page, total.
Options: comment (A comment’s repliesCursor from an earlier response. Returns that comment’s replies), sort, cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call. Works without an API key.

Example response

{
  "results": [
    {
      "id": "UgyEnXfdC-umwvTt8JF4AaABAg",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=UgyEnXfdC-umwvTt8JF4AaABAg",
      "author": {
        "id": "UCWf34D_s8K_m2vwBISIDWtg",
        "name": "Oatman69",
        "handle": "Oatman69",
        "url": "https://www.youtube.com/channel/UCWf34D_s8K_m2vwBISIDWtg",
        "avatarUrl": null
      },
      "text": "Gonna flag this for nudity so I can rick roll the YouTube staff",
      "publishedAt": "2020-01-01T00:00:00.000Z",
      "likes": 569000,
      "replies": 726,
      "parentId": null,
      "isPinned": false,
      "isHearted": false,
      "isChannelOwner": false,
      "repliesCursor": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd5RW5YZmRDLXVtd3ZUdDhKRjRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVd…"
    }
  ],
  "cursor": "Eg0SC2RRdzR3OVdnWGNRGAYy_gIK1AJnZXRfcmFua2VkX3N0cmVhbXMtLUNxWUJDSUFFRlJlMzBUZ2Ftd0VLbGdFSTJGOFFnQVFZQnlLTEFWdDhhbWV6S3llMWJCOXJJR3BXbmlPZVpDbFJpRDBvc2JZX0FPY...",
  "page": null,
  "total": null
}

youtube-channel

A YouTube channel link: @handle, /channel/, /c/ or /user/, with an optional tab.

Example page: https://www.youtube.com/@mkbhd
Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
Options: tab (YouTube’s own channel tab. Releases are a music channel’s albums), sort (YouTube’s own sort for the videos, shorts and live tabs), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call. Works without an API key.

Example response

{
  "id": "UCBJycsmduvYEL83R_U4JriQ",
  "url": "https://www.youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ",
  "handle": "mkbhd",
  "name": "Marques Brownlee",
  "bio": "MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n…",
  "avatarUrl": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s900-c-k-c…",
  "isVerified": null,
  "followers": 21400000,
  "following": null,
  "posts": 1800,
  "website": null,
  "location": "United States",
  "category": null,
  "bannerUrl": "https://yt3.googleusercontent.com/zi_48HwHU4s0Hnb6tZuvRzTfCPHrLEnrtIMDLzMauDEyDmURh9JZ4wrNd3lKr7m9uVnT4YjYKw=w2560-fcro…",
  "joinedDate": "2008-03-21",
  "totalViews": 5868481445,
  "results": [
    {
      "description": null,
      "likes": null,
      "comments": null,
      "type": "video",
      "title": "OLED iPad Mini is The Most Apple Product They've Ever Appled",
      "durationSeconds": 780,
      "views": 7500000,
      "thumbnailUrl": "https://i.ytimg.com/vi/g6Die8gVFn0/hqdefault.jpg",
      "isShort": false,
      "isLive": false,
      "publishedAt": "2026-11-03T00:00:00.000Z",
      "id": "g6Die8gVFn0",
      "url": "https://www.youtube.com/watch?v=g6Die8gVFn0",
      "author": {
        "id": "UCBJycsmduvYEL83R_U4JriQ",
        "name": "Marques Brownlee",
        "handle": "mkbhd",
        "url": "https://www.youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ",
        "avatarUrl": null
      },
      "hashtags": []
    }
  ],
  "cursor": "4qmFsgLZCRIYVUNCSnljc21kdXZZRUw4M1JfVTRKcmlRGrwJOGdhRUJ4cUJCM3ItQmpyN0Jnb2tObUkxTTJJNFpqSXRNREF3TUMweU5URmpMV0l6Tm1JdE5UZ3lOREk1WTJJME5ESXdFdEFHUVdOV09GWmtWe..."
}

youtube-post

A YouTube community post link: /post/Ugkx… or a community page with ?lb=.

Example page: https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ
Returns: One post: id, url, title, text, author, community, publishedAt, likes, comments, shares, views, media, hashtags.
Options: sort (YouTube’s own comment sort), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "id": "UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ",
  "url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ",
  "title": null,
  "text": "Alright, it's that time: https://vote.mkbhd.com\n\nWelcome to the Blind Smartphone Camera Test 2023! 20 smartphones. 3…",
  "author": null,
  "community": null,
  "publishedAt": "2024-01-01T00:00:00.000Z",
  "likes": 12000,
  "comments": 1043,
  "shares": null,
  "views": null,
  "media": [
    {
      "type": "image",
      "url": "https://yt3.ggpht.com/zy6PEg0QzlzFe8xfDxpAbe1mGV0pXgc-xV1MvQ7rlf_EWjEj_YqN0Y2b7fiaOCdghICsMxy8tDGDaA=s1516-rw-nd-v1"
    }
  ],
  "hashtags": [],
  "videoId": null,
  "videoTitle": null,
  "pollChoices": [],
  "pollTotalVotes": null,
  "commentList": [
    {
      "text": "waiting for the new video, \"Let's Talk About Vehicular Felonies.\"",
      "likes": 204,
      "replies": 2,
      "publishedAt": "2025-01-01T00:00:00.000Z",
      "isPinned": false,
      "isHearted": false,
      "isChannelOwner": false,
      "repliesCursor": "4qmFsgLQAhIrRkVjb21tZW50X3Bvc3RfZGV0YWlsX3BhZ2Vfd2ViX3JlcGxpZXNfcGFnZRqgAkVnVndiM04wYzhvQko3SUJKRlZuYTNoWU5tZHJSSGhSTUV…",
      "id": "Ugwy052tBWynxReFHN94AaABAg",
      "url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ?lc=Ugwy052tBWynxReFHN94AaABAg",
      "author": {
        "id": "UCjU-RRrNmxYVD5RpCuaKZBw",
        "name": "Kirkenheimer15",
        "handle": "Kirkenheimer15",
        "url": "https://www.youtube.com/channel/UCjU-RRrNmxYVD5RpCuaKZBw",
        "avatarUrl": null
      },
      "parentId": null
    }
  ],
  "cursor": "4qmFsgKFBRIoRkVjb21tZW50X3Bvc3RfZGV0YWlsX3BhZ2Vfd2ViX3RvcF9sZXZlbBrYBEVnVndiM04wYzZvRHR3TUswd0puWlhSZmNtRnVhMlZrWDNOMGNtVmhiWE10TFVOeFZVSkRTVUZGUmxKbE16QlVaM..."
}

youtube-playlist

A YouTube playlist page with list in the link.

Example page: https://www.youtube.com/playlist?list=PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI
Returns: A list of videos: results, cursor, page, total.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "fOT0BUpITw8",
      "url": "https://www.youtube.com/watch?v=fOT0BUpITw8",
      "title": "BELLAKEO (Video Oficial) - Peso Pluma, Anitta",
      "description": null,
      "author": {
        "id": "UCzrM_068Odho89mTRrrxqbA",
        "name": "Peso Pluma",
        "handle": null,
        "url": "https://www.youtube.com/channel/UCzrM_068Odho89mTRrrxqbA",
        "avatarUrl": null
      },
      "publishedAt": "2024-01-01T00:00:00.000Z",
      "durationSeconds": 235,
      "views": 774000000,
      "likes": null,
      "comments": null,
      "thumbnailUrl": "https://i.ytimg.com/vi/fOT0BUpITw8/hqdefault.jpg",
      "hashtags": [],
      "type": "video",
      "isShort": false,
      "isLive": false
    }
  ],
  "cursor": "4qmFsgKBARIkVkxQTEZncXVMbkw1OWFsQ2xfMlRRdk9pRDVWZ20xaENhR1NJGjRDQUY2SGxCVU9rTkhVV2xGUlZrMVVXdGFRazFVWXpOT1JFazFUWHBSZVU5RVdRJTNEJTNEmgIiUExGZ3F1TG5MNTlhbENsX...",
  "page": null,
  "total": 182,
  "playlist": {
    "id": "PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI",
    "url": "https://www.youtube.com/playlist?list=PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI",
    "title": "Popular Music Videos",
    "description": null,
    "author": {
      "id": "UC-9-kyTW8ZkZNDHQJ6FgpwQ",
      "name": "Music",
      "handle": null,
      "url": "https://www.youtube.com/channel/UC-9-kyTW8ZkZNDHQJ6FgpwQ",
      "avatarUrl": null
    },
    "videoCount": 182,
    "views": 1045675568,
    "hiddenVideos": 0,
    "thumbnailUrl": "https://i.ytimg.com/vi/fOT0BUpITw8/hqdefault.jpg"
  }
}

tiktok-video

A TikTok video page or share link.

Example page: https://www.tiktok.com/@charlidamelio/video/7137423965982592302
Returns: One video: id, url, title, description, author, publishedAt, durationSeconds, views, likes, comments, thumbnailUrl, hashtags.
Price: 1 credit per call.

Example response

{
  "id": "7137423965982592302",
  "url": "https://www.tiktok.com/@charlidamelio/video/7137423965982592302",
  "title": null,
  "description": null,
  "author": {
    "id": "5831967",
    "name": "charli d’amelio",
    "handle": "charlidamelio",
    "url": "https://www.tiktok.com/@charlidamelio",
    "avatarUrl": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:7…",
    "isVerified": true
  },
  "publishedAt": "2022-08-29T22:10:18.000Z",
  "durationSeconds": 11,
  "views": 22000000,
  "likes": 2100000,
  "comments": 19000,
  "thumbnailUrl": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/c1844bce7c5a4b07b0e4ae2301a1996a~tplv-tiktokx-origin.ima…",
  "hashtags": [],
  "type": "video",
  "mentions": [],
  "imageUrls": [],
  "shares": 17300,
  "saves": 83186,
  "audioId": "7090403288818584347",
  "audioTitle": "Streets x Kiss it better",
  "audioArtist": ":p",
  "audioIsOriginal": true,
  "isAd": false,
  "isAiGenerated": false,
  "country": "US",
  "downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/f7803ec144cb492986bb4b6056003a3c/?a=1988&bti…",
  "watermarkedDownloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/0641e3a6387a49e4a2c8c4de2c457fe8/?a=1988&bti…",
  "downloadExpiresAt": "2026-11-06T23:11:21.000Z",
  "downloadHeaders": {
    "referer": "https://www.tiktok.com/",
    "cookie": "tt_chain_token=jE4h20rgHlMmu7QChS5S5Q=="
  },
  "audioUrl": "https://v45.tiktokcdn-eu.com/852d1747fbc73b4bca955665607a30e5/6aed0d19/video/tos/no1a/tos-no1a-v-2370c710-no/1643bebb34…",
  "width": 576,
  "height": 1024,
  "quality": "540p"
}

tiktok-comments

A TikTok video page or share link.

Example page: https://www.tiktok.com/@charlidamelio/video/7137423965982592302
Returns: A list of comments: results, cursor, page, total.
Options: comment, cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "7137510823549272878",
      "url": null,
      "author": {
        "id": "6811167419379434502",
        "name": "🤓",
        "handle": "your.mom4573",
        "url": "https://www.tiktok.com/@your.mom4573",
        "avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352895290313015339~tplv-tiktokx-cropcenter:100:100.jp…"
      },
      "text": "Charli Barker",
      "publishedAt": "2022-08-30T03:47:36.000Z",
      "likes": 5162,
      "replies": 45,
      "parentId": null,
      "imageUrls": []
    }
  ],
  "cursor": "seen_0ee8c910-1f0c-4385-9f41-8843d5ff878b",
  "page": null,
  "total": null
}

tiktok-transcript

A TikTok video page or share link.

Example page: https://www.tiktok.com/@charlidamelio/video/7137423965982592302
Returns: startSeconds, endSeconds, text.
Options: language (BCP 47 language tag, e.g. en or pt-BR. Any case is accepted), includeTimestamps.
Price: 1 credit when the video has captions; otherwise 2 credits plus 1 credit for every 10 seconds of audio, up to 3 minutes. Works without an API key.

Example response

{
  "videoId": "7137423965982592302",
  "videoUrl": "https://www.tiktok.com/@charlidamelio/video/7137423965982592302",
  "language": "en",
  "isAutoGenerated": true,
  "durationSeconds": 11.12375,
  "transcribedSeconds": 12,
  "text": "First time, first time, first time, look you in your eyes What are you willing to do? Oh, tell me what you're willing…"
}

tiktok-profile

A TikTok profile page. Send options view videos to page through its videos.

Example page: https://www.tiktok.com/@khaby.lame
Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call. Works without an API key.

Example response

{
  "id": "127905465618821121",
  "url": "https://www.tiktok.com/@khaby.lame",
  "handle": "khaby.lame",
  "name": "Khabane lame",
  "bio": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎",
  "avatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcen…",
  "isVerified": true,
  "followers": 162955695,
  "following": 82,
  "posts": 1359,
  "website": null,
  "location": null,
  "category": null,
  "likes": 2692469127,
  "isPrivate": false,
  "isOrganization": false,
  "language": "en",
  "createdAt": "2016-08-10T22:02:34.000Z",
  "videos": [
    {
      "id": "7697307919943060767",
      "url": "https://www.tiktok.com/@khaby.lame/video/7697307919943060767",
      "title": null,
      "description": "I guess is time to retire #learnfromkhaby #comedy 🥊",
      "author": {
        "id": "127905465618821121",
        "name": "Khabane lame",
        "handle": "khaby.lame",
        "url": "https://www.tiktok.com/@khaby.lame",
        "avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcen…",
        "isVerified": true
      },
      "publishedAt": "2026-10-16T16:46:21.000Z",
      "durationSeconds": 9,
      "views": 5900000,
      "likes": 339300,
      "comments": 8538,
      "thumbnailUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQbHQmFfa5VY3NlkEGDAQT00RzqAqBOETlEafj~tplv-tiktokx-ori…",
      "hashtags": [
        "learnfromkhaby",
        "comedy"
      ],
      "type": "video",
      "mentions": [],
      "imageUrls": [],
      "shares": 33800,
      "saves": 17934,
      "audioId": "7697308007327730462",
      "audioTitle": "original sound",
      "audioArtist": "Khabane lame",
      "audioIsOriginal": true,
      "isAd": false,
      "isAiGenerated": false
    }
  ],
  "videosCursor": "1781017260242:7649410784241405214"
}

tiktok-hashtag

A TikTok hashtag page.

Example page: https://www.tiktok.com/tag/booktok
Returns: A list of videos: results, cursor, page, total.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "7223827494913215786",
      "url": "https://www.tiktok.com/@jenna_bushhager/video/7223827494913215786",
      "title": null,
      "description": "#WorldBookDay is 4/23, and I've joined the #BookTok community to share our favorite books with you all! Duet to share…",
      "author": {
        "id": "6915876645917082629",
        "name": "Jenna Bush Hager",
        "handle": "jenna_bushhager",
        "url": "https://www.tiktok.com/@jenna_bushhager",
        "avatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/0707efff51851e19e5e88f36bd87a298~tplv-tiktokx-cropcen…",
        "isVerified": true
      },
      "publishedAt": "2023-04-19T18:20:30.000Z",
      "durationSeconds": 82,
      "views": 39200,
      "likes": 998,
      "comments": 34,
      "thumbnailUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ce0ee016ff8a483e8271ed4b4faebb3a~tplv-tiktokx-origin.ima…",
      "hashtags": [
        "worldbookday",
        "booktok",
        "passthebook"
      ],
      "type": "video",
      "mentions": [],
      "imageUrls": [],
      "shares": 36,
      "saves": 134,
      "audioId": "7223827501163006766",
      "audioTitle": "original sound",
      "audioArtist": "Jenna Bush Hager",
      "audioIsOriginal": true,
      "isAd": false,
      "isAiGenerated": false
    }
  ],
  "cursor": "seen_913912c8-cf6c-4cf4-b00f-7e95f9525571",
  "page": null,
  "total": null
}

tiktok-sound

A TikTok sound page that ends in the sound id.

Example page: https://www.tiktok.com/music/original-sound-7652012548169976607
Returns: A list of videos: results, cursor, page, total.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "7652012587009215774",
      "url": "https://www.tiktok.com/@khaby.lame/video/7652012587009215774",
      "title": null,
      "description": "Bro…. Where is the rest of my rice? 🍚🤨#learnfromkhaby #comedy ",
      "author": {
        "id": "127905465618821121",
        "name": "Khabane lame",
        "handle": "khaby.lame",
        "url": "https://www.tiktok.com/@khaby.lame",
        "avatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcen…",
        "isVerified": true
      },
      "publishedAt": "2026-06-16T15:17:17.000Z",
      "durationSeconds": 30,
      "views": 77400000,
      "likes": 3500000,
      "comments": 52800,
      "thumbnailUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMCUBOFruAxeDj4qAILfYaqGVewvlQtIIIC0xI~tplv-tiktokx-ori…",
      "hashtags": [
        "learnfromkhaby",
        "comedy"
      ],
      "type": "video",
      "mentions": [],
      "imageUrls": [],
      "shares": 305800,
      "saves": 154390,
      "audioId": "7652012548169976607",
      "audioTitle": "original sound",
      "audioArtist": "Khabane lame",
      "audioIsOriginal": true,
      "isAd": false,
      "isAiGenerated": false
    }
  ],
  "cursor": "seen_62f0083f-2789-4e1b-b88a-52aa4400f7d3",
  "page": null,
  "total": null,
  "sound": {
    "audioId": "7652012548169976607",
    "audioTitle": "original sound",
    "audioArtist": "Khabane lame",
    "audioIsOriginal": true,
    "videos": 411
  }
}

tiktok-search

A TikTok user search page (/search/user) or video search page (/search) with a q query.

Example page: https://www.tiktok.com/search/user?q=street%20food
Returns: A list of profiles: results, cursor, page, total.
Options: sort (TikTok’s Sort by, for videos. Leave out for Relevance), datePosted (TikTok’s Date posted, for videos. Leave out for All time), cursor (The cursor from the previous response. Send it as is), query, type.
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "7329614299667727392",
      "url": "https://www.tiktok.com/@streetfoodies33",
      "handle": "streetfoodies33",
      "name": "street food",
      "bio": "Street food humour abonne-toi et explore une gastronomie unique et savoureuse 🌍",
      "avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/4ea0a8bbd98dc054cb6afcd80f4467a7~tplv-tiktokx-cropcenter:1…",
      "isVerified": false,
      "followers": 113300,
      "following": null,
      "posts": null,
      "website": null,
      "location": null,
      "category": null,
      "likes": 924514
    }
  ],
  "cursor": "seen_7b2e4f1c-90dc-4640-a041-6bdd616a5310",
  "page": null,
  "total": null
}

tiktok-followers

A TikTok profile page.

Example page: https://www.tiktok.com/@khaby.lame
Returns: A list of profiles: results, cursor, page, total.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "7343882690238399494",
      "url": "https://www.tiktok.com/@fatih.ged",
      "handle": "fatih.ged",
      "name": "Fatih Ged",
      "bio": "صعدوا حسابي",
      "avatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/02f1a89794af18c2c21b297dfe7ecd8b~tplv-tiktokx-cropcenter:10…",
      "isVerified": false,
      "followers": 434,
      "following": 1707,
      "posts": 124,
      "website": null,
      "location": null,
      "category": null,
      "likes": 1476,
      "isPrivate": false,
      "isOrganization": false,
      "language": null,
      "createdAt": null
    }
  ],
  "cursor": "1793833913",
  "page": null,
  "total": null
}

tiktok-following

A TikTok profile page.

Example page: https://www.tiktok.com/@khaby.lame
Returns: A list of profiles: results, cursor, page, total.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "6769661547985847302",
      "url": "https://www.tiktok.com/@xeviuniverse",
      "handle": "xeviuniverse",
      "name": "Xevi",
      "bio": "Email: name@example.com\nPodcast ⬇️",
      "avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/5f78661ab7569a41cae5e990d2316eee~tplv-tiktokx-cropcen…",
      "isVerified": false,
      "followers": 5336663,
      "following": 245,
      "posts": 1165,
      "website": null,
      "location": null,
      "category": null,
      "likes": 241600649,
      "isPrivate": false,
      "isOrganization": false,
      "language": null,
      "createdAt": null
    }
  ],
  "cursor": "1659875581",
  "page": null,
  "total": null
}

instagram-transcript

An Instagram reel or video post.

Example page: https://www.instagram.com/reel/DfS8Xbng4MD/
Returns: startSeconds, endSeconds, text.
Options: language (BCP 47 language tag, e.g. en or pt-BR. Any case is accepted), includeTimestamps.
Price: 1 credit plus 1 credit for every 30 seconds of audio, up to 5 minutes.

Example response

{
  "videoId": "DfS8Xbng4MD",
  "videoUrl": "https://www.instagram.com/reel/DfS8Xbng4MD/",
  "language": "en",
  "isAutoGenerated": true,
  "durationSeconds": 10.9879375,
  "transcribedSeconds": 11,
  "text": "For more information visit www.fema.gov"
}

Get started

Parsers

Guides

Plans and billing

youtube-search

youtube-video

youtube-transcript

youtube-comments

youtube-channel

youtube-post

youtube-playlist

tiktok-video

tiktok-comments

tiktok-transcript

tiktok-profile

tiktok-hashtag

tiktok-sound

tiktok-search

tiktok-followers

tiktok-following

instagram-transcript

​youtube-search

​youtube-video

​youtube-transcript

​youtube-comments

​youtube-channel

​youtube-post

​youtube-playlist

​tiktok-video

​tiktok-comments

​tiktok-transcript

​tiktok-profile

​tiktok-hashtag

​tiktok-sound

​tiktok-search

​tiktok-followers

​tiktok-following

​instagram-transcript

youtube-search

youtube-video

youtube-transcript

youtube-comments

youtube-channel

youtube-post

youtube-playlist

tiktok-video

tiktok-comments

tiktok-transcript

tiktok-profile

tiktok-hashtag

tiktok-sound

tiktok-search

tiktok-followers

tiktok-following

instagram-transcript