API reference

Every endpoint is a GET with query parameters and returns JSON. The same field names are used on every platform.

194endpoints

33platforms

https://scrapeio.combase URL

/

Quickstart

Create a key on your dashboard and send it in the x-api-key header (Authorization: Bearer works too). Each key can make 300 requests a minute.

curl \
  "https://scrapeio.com/v1/tiktok/profile?handle=khaby.lame" \
  -H "x-api-key: $SCRAPEIO_KEY"

const res = await fetch(
  "https://scrapeio.com/v1/tiktok/profile?handle=khaby.lame",
  { headers: { "x-api-key": process.env.SCRAPEIO_KEY } },
);
const { data } = await res.json();
console.log(data.followers);

import os, requests

r = requests.get(
    "https://scrapeio.com/v1/tiktok/profile?handle=khaby.lame",
    headers={"x-api-key": os.environ["SCRAPEIO_KEY"]},
)
print(r.json()["data"]["followers"])

// Claude, Cursor or any MCP client
{
  "mcpServers": {
    "scrapeio": {
      "type": "http",
      "url": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}

Responses and errors

Every response has success, cached, credits_used, credits_remaining and data. You are only charged for a fresh answer.

Status	Meaning	Charged
200	Success	Yes, unless cached
400	A parameter is missing or wrong	No
401	The key is missing or invalid	No
402	Not enough credits	No
403	The account or post is private	No
404	Not found on the platform	No
429	More than 300 requests a minute	No
502	Every source is down; retry shortly	No

Pagination

Lists return items, has_more and cursor. For the next page, send the same request with cursor set to that value.

AI agents (MCP)

Add this server to Claude, Cursor or any MCP client. Each endpoint becomes a tool with its parameters. The full spec is at openapi.json.

{
  "mcpServers": {
    "scrapeio": {
      "type": "http",
      "url": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}

TikTok23 endpoints

GET/v1/tiktok/profile1 credit

TikTok profile: bio, avatar, followers, following, likes, video count.

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.

curl "https://scrapeio.com/v1/tiktok/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v3/tiktok/profile/videos1 credit

A profile's videos, newest first, with plays, likes, comments, shares and saves.

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v3/tiktok/profile/videos?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v2/tiktok/video1 credit

One TikTok video by URL: stats, caption, author, music, download URL.

Parameter	Type	Description
`url`required	string	TikTok video URL.

curl "https://scrapeio.com/v2/tiktok/video?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/video/transcript1 credit

Spoken-word transcript of a TikTok video, from its captions.

Parameter	Type	Description
`url`required	string	TikTok video URL.
`language`	string	Preferred language code, e.g. en.

curl "https://scrapeio.com/v1/tiktok/video/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/video/comments1 credit

Comments on a TikTok video, most liked first.

Parameter	Type	Description
`url`required	string	TikTok video URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/video/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/video/comment/replies1 credit

Replies to one TikTok comment.

Parameter	Type	Description
`url`required	string	TikTok video URL.
`comment_id`required	string	Comment id from the comments endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/video/comment/replies?url=...&comment_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/keyword1 credit

Search TikTok videos by keyword.

Parameter	Type	Description
`query`required	string	Search text.
`sort_by`	relevance, most-liked, latest	Sort order.
`date_posted`	all, yesterday, this-week, this-month, last-3-months, last-6-months	Posted within.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/search/keyword?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/users1 credit

Search TikTok accounts by keyword.

Parameter	Type	Description
`query`required	string	Search text.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/search/users?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/hashtag1 credit

Videos under a hashtag, plus the hashtag's totals.

Parameter	Type	Description
`hashtag`required	string	Hashtag, with or without #.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/search/hashtag?hashtag=travel" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/trending1 credit

Trending feed for a region.

Parameter	Type	Description
`region`	string	Two-letter country code. Default: US.

curl "https://scrapeio.com/v1/tiktok/trending" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/followers1 credit

A profile's followers, newest first.

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/user/followers?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/liked1 credit

Videos a profile has liked (when public).

Parameter	Type	Description
`handle`required	string	TikTok username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/user/liked?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/song1 credit

A TikTok sound: title, author, duration, usage count.

Parameter	Type	Description
`url`required	string	TikTok sound or video URL.

curl "https://scrapeio.com/v1/tiktok/song?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/song/videos1 credit

Videos that use a sound.

Parameter	Type	Description
`music_id`required	string	Sound id from the song endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/tiktok/song/videos?music_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/collection/videos3 credits

Collection Videos

Parameter	Type	Description
`url`required	string	Public TikTok collection URL
`cursor`	string	Cursor to get more videos.

curl "https://scrapeio.com/v1/tiktok/collection/videos?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/get-trending-feed3 credits

Trending Feed

Parameter	Type	Description
`region`required	string	Where you want the proxy to be.
`trim`	boolean	Set to true to get a trimmed response.

curl "https://scrapeio.com/v1/tiktok/get-trending-feed?region=US" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/live3 credits

Live Info

Parameter	Type	Description
`room_id`required	string	TikTok live room id.
`user_id`required	string	TikTok numeric user id for the live owner.

curl "https://scrapeio.com/v1/tiktok/live?room_id=...&user_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/profile/region3 credits

Profile Region

Parameter	Type	Description
`handle`required	string	TikTok handle

curl "https://scrapeio.com/v1/tiktok/profile/region?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/suggestions3 credits

Search Suggestions

Parameter	Type	Description
`query`required	string	Search query to get suggestions for
`region`	string	Region code for suggestions

curl "https://scrapeio.com/v1/tiktok/search/suggestions?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/search/top3 credits

Top Search

Parameter	Type	Description
`query`required	string	Keyword to search for
`publish_time`	yesterday, this-week, this-month, last-3-months, last-6-months, all-time	Time Frame TikTok was posted
`sort_by`	relevance, most-liked, date-posted	Sort by
`region`	string	Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there.
`cursor`	string	Cursor to get more videos.

curl "https://scrapeio.com/v1/tiktok/search/top?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/audienceup to 78 credits

User's Audience Demographics

Parameter	Type	Description
`handle`required	string	TikTok handle

curl "https://scrapeio.com/v1/tiktok/user/audience?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/following3 credits

Following

Parameter	Type	Description
`handle`required	string	TikTok handle
`trim`	boolean	Set to true to get a trimmed response
`min_time`	string	Used to paginate.

curl "https://scrapeio.com/v1/tiktok/user/following?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/live3 credits

Live

Parameter	Type	Description
`handle`required	string	TikTok handle

curl "https://scrapeio.com/v1/tiktok/user/live?handle=nike" \
  -H "x-api-key: YOUR_KEY"

Instagram23 endpoints

GET/v1/instagram/profile1 credit

Instagram profile: bio, avatar, followers, following, post count, category.

Parameter	Type	Description
`handle`required	string	Instagram username, with or without @.

curl "https://scrapeio.com/v1/instagram/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v2/instagram/user/posts1 credit

A profile's posts of every type (reels, photos, carousels), newest first, with real play counts.

Parameter	Type	Description
`handle`required	string	Instagram username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v2/instagram/user/posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/instagram/user/reels1 credit

A profile's reels with real play counts.

Parameter	Type	Description
`handle`required	string	Instagram username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/instagram/user/reels?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/instagram/post1 credit

One post or reel by URL: plays, likes, comments, caption, media URLs.

Parameter	Type	Description
`url`required	string	Instagram post or reel URL.

curl "https://scrapeio.com/v1/instagram/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v2/instagram/post/comments1 credit

Comments on a post or reel.

Parameter	Type	Description
`url`required	string	Instagram post or reel URL.
`sort`	recent, popular	recent pages with likes; popular returns the top 15. Default: recent.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v2/instagram/post/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/instagram/post/comment/replies1 credit

Replies to one Instagram comment.

Parameter	Type	Description
`url`required	string	Instagram post or reel URL.
`comment_id`required	string	Comment id from the comments endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/instagram/post/comment/replies?url=...&comment_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v2/instagram/media/transcript2 credits

Transcript of a reel (videos under 2 minutes).

Parameter	Type	Description
`url`required	string	Instagram reel URL.

curl "https://scrapeio.com/v2/instagram/media/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/instagram/search1 credit

Search Instagram accounts and hashtags.

Parameter	Type	Description
`query`required	string	Search text.

curl "https://scrapeio.com/v1/instagram/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/instagram/search/posts1 credit

Search Instagram posts and reels by keyword.

Parameter	Type	Description
`query`required	string	Search text.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/instagram/search/posts?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/instagram/hashtag1 credit

Parameter	Type	Description
`handle`	string	Instagram username.
`user_id`	string	Instagram user id. Send this or handle.

Parameter	Type	Description
`id`required	string	Highlight id from the highlights endpoint.

Parameter	Type	Description
`handle`required	string	Instagram username.

Parameter	Type	Description
`user_id`	string	Instagram user id.
`handle`	string	Instagram username. Send this or user_id.
`cursor`	string	Cursor from the previous page's data.cursor.

Parameter	Type	Description
`audio_id`required	string	The audio id from the Instagram audio page URL.
`cursor`	string	Pagination cursor returned by Instagram from the previous response.

Parameter	Type	Description
`userId`	string	Instagram user id
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

Parameter	Type	Description
`query`required	string	The Popular topic to search for.
`cursor`	string	The opaque cursor returned by the previous response.

Parameter	Type	Description
`handle`required	string	Instagram handle

Parameter	Type	Description
`query`required	string	The keyword to search for
`date_posted`	last-week, last-month, last-year	Google-indexed date window.
`page`	string	The page number to return.

YouTube19 endpoints

GET/v1/youtube/channel1 credit

YouTube channel: subscribers, total views, video count, description.

Parameter	Type	Description
`handle`required	string	Channel @handle, channel URL, or UC… channel id.

curl "https://scrapeio.com/v1/youtube/channel?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel-videos1 credit

A channel's uploads (videos and Shorts), newest first, with views, likes and comments.

Parameter	Type	Description
`handle`required	string	Channel @handle, channel URL, or UC… channel id.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel-videos?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video1 credit

One YouTube video or Short by URL: views, likes, comments, duration, tags.

Parameter	Type	Description
`url`required	string	YouTube video or Short URL.

curl "https://scrapeio.com/v1/youtube/video?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/comments1 credit

Comments on a YouTube video.

Parameter	Type	Description
`url`required	string	YouTube video URL.
`order`	relevance, time	Ranking. Default: relevance.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/video/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/search2 credits

Search YouTube videos with full stats.

Parameter	Type	Description
`query`required	string	Search text.
`sort_by`	relevance, date, viewCount, rating	Ranking. Default: relevance.
`published_after`	string	RFC 3339 time, e.g. 2026-01-01T00:00:00Z.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/download2 credits

Direct MP4 stream URLs for a video (360p with audio, plus every format).

Parameter	Type	Description
`url`required	string	YouTube video URL.

curl "https://scrapeio.com/v1/youtube/video/download?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/playlist1 credit

A playlist's details and its videos, with views and likes.

Parameter	Type	Description
`playlist_id`required	string	Playlist id or playlist URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/playlist?playlist_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/playlists1 credit

A channel's public playlists.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel/playlists?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/shorts1 credit

A channel's Shorts, newest first, with views and likes.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel/shorts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/lives1 credit

A channel's past and current live streams.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/channel/lives?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/comment/replies1 credit

Replies to one YouTube comment.

Parameter	Type	Description
`comment_id`required	string	Comment id from the comments endpoint.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/youtube/video/comment/replies?comment_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/search/typeahead1 credit

Search suggestions YouTube shows as you type.

Parameter	Type	Description
`query`required	string	Partial search text.

curl "https://scrapeio.com/v1/youtube/search/typeahead?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/community-posts1 credit

A channel's community posts: text, images, polls, likes and comments.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.
`continuationToken`	string	Same as cursor, under ScrapeCreators' name.

curl "https://scrapeio.com/v1/youtube/channel/community-posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/community-post1 credit

One community post with its text, images and likes.

Parameter	Type	Description
`url`required	string	Community post URL.

curl "https://scrapeio.com/v1/youtube/community-post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/channel/search1 credit

Search inside one channel's videos.

Send one of: handle, channelId.

Parameter	Type	Description
`handle`	string	Channel handle, e.g. @MrBeast.
`channelId`	string	Channel id (UC...). Send this or handle.
`query`required	string	Search text.
`cursor`	string	Cursor from the previous page's data.cursor.
`continuationToken`	string	Same as cursor, under ScrapeCreators' name.

curl "https://scrapeio.com/v1/youtube/channel/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/search/hashtag1 credit

Videos under a YouTube hashtag, with views and length.

Parameter	Type	Description
`hashtag`required	string	Hashtag, with or without #.
`cursor`	string	Cursor from the previous page's data.cursor.
`continuationToken`	string	Same as cursor, under ScrapeCreators' name.

curl "https://scrapeio.com/v1/youtube/search/hashtag?hashtag=travel" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/shorts/trending3 credits

Trending Shorts

No parameters.

curl "https://scrapeio.com/v1/youtube/shorts/trending" \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/sponsors3 credits

Video Sponsors

Parameter	Type	Description
`url`required	string	YouTube video or short URL
`language`	string	2 letter language code used for transcript lookup, ie 'en', 'es', 'fr' etc.

curl "https://scrapeio.com/v1/youtube/video/sponsors?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/youtube/video/transcript3 credits

Transcript

Parameter	Type	Description
`url`required	string	YouTube video or short URL
`language`	string	Language code, ie 'en', 'es', 'fr' or 'en-US'.
`original_audio`	boolean	Set to true to return captions only in the original spoken language identified by YouTube.
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/youtube/video/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

X (Twitter)10 endpoints

GET/v1/twitter/profile1 credit

X profile: bio, avatar, followers, following, post count.

Parameter	Type	Description
`handle`required	string	X username, with or without @.

curl "https://scrapeio.com/v1/twitter/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitter/user-tweets1 credit

A profile's posts, newest first, with views, likes, reposts, replies and bookmarks.

Parameter	Type	Description
`handle`required	string	X username, with or without @.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/twitter/user-tweets?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitter/tweet1 credit

One post by URL or id.

Parameter	Type	Description
`url`required	string	X post URL.

curl "https://scrapeio.com/v1/twitter/tweet?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitter/tweet/replies1 credit

Latest replies to a post.

Parameter	Type	Description
`url`required	string	X post URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/twitter/tweet/replies?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitter/search1 credit

Search X posts. X search operators work.

Parameter	Type	Description
`query`required	string	Search text.
`type`	top, latest	Ranking. Default: top.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/twitter/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitter/trends1 credit

Facebook12 endpoints

GET/v1/facebook/profile1 credit

Facebook profile or Page: name, avatar, followers, category.

Parameter	Type	Description
`url`required	string	Facebook profile or Page URL, profile.php?id= URL, numeric id, or Page name.

curl "https://scrapeio.com/v1/facebook/profile?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/profile/posts1 credit

Posts from a profile or Page with reactions, comments and shares.

Parameter	Type	Description
`url`required	string	Facebook profile or Page URL, profile.php?id= URL, numeric id, or Page name.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/facebook/profile/posts?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/profile/reels1 credit

Videos and reels from a profile or Page with view counts.

Parameter	Type	Description
`url`required	string	Facebook profile or Page URL, profile.php?id= URL, numeric id, or Page name.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/facebook/profile/reels?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/post1 credit

One Facebook post, video or reel by URL: views, reactions, comments, shares, video URL.

Parameter	Type	Description
`url`required	string	Facebook post, video or reel URL.

curl "https://scrapeio.com/v1/facebook/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/post/comments1 credit

Top-level comments on a Facebook post or video.

Parameter	Type	Description
`url`required	string	Facebook post or video URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/facebook/post/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/group3 credits

Facebook Group Info

Parameter	Type	Description
`url`	string	The Facebook group URL.
`group_id`	string	The numeric Facebook group ID.

curl "https://scrapeio.com/v1/facebook/group" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/group/posts3 credits

Facebook Group Posts

Parameter	Type	Description
`url`	string	The URL of the group
`group_id`	string	The ID of the group
`sort_by`	TOP_POSTS, RECENT_ACTIVITY, CHRONOLOGICAL, CHRONOLOGICAL_LISTINGS	How to sort the posts.
`cursor`	string	The cursor to paginate to the next page

curl "https://scrapeio.com/v1/facebook/group/posts" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/post/comment/replies3 credits

Comment Replies

Parameter	Type	Description
`feedback_id`required	string	The feedbackid of the comment.
`expansion_token`required	string	The expansiontoken of the comment.
`cursor`	string	The cursor to paginate to the next page

curl "https://scrapeio.com/v1/facebook/post/comment/replies?feedback_id=...&expansion_token=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/post/transcript3 credits

Transcript

Parameter	Type	Description
`url`required	string	Facebook post URL
`allow_long_transcription`	boolean	Paid opt-in, enabled only by the literal query value 'true' (allowlongtranscription=true).
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/facebook/post/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/profile/events3 credits

Profile Events

Parameter	Type	Description
`url`required	string	The URL of the public Facebook page
`cursor`	string	The cursor to paginate to get more events

curl "https://scrapeio.com/v1/facebook/profile/events?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/profile/photos3 credits

Profile Photos

Parameter	Type	Description
`url`required	string	Facebook page URL
`next_page_id`	string	To paginate through to the next page
`cursor`	string	To paginate through to the next page

curl "https://scrapeio.com/v1/facebook/profile/photos?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/search/videos3 credits

Search Videos

Parameter	Type	Description
`query`required	string	The keyword or phrase to search for
`cursor`	string	The opaque cursor returned by the previous response.

curl "https://scrapeio.com/v1/facebook/search/videos?query=coffee" \
  -H "x-api-key: YOUR_KEY"

Cosmos7 endpoints

GET/v1/cosmos/cluster3 credits

Collection

Parameter	Type	Description
`url`required	string	Public Cosmos collection URL.

curl "https://scrapeio.com/v1/cosmos/cluster?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/cosmos/cluster/posts3 credits

Collection Posts

Parameter	Type	Description
`url`required	string	Public Cosmos collection URL.
`cursor`	string	Pass the previous response cursor unchanged.

curl "https://scrapeio.com/v1/cosmos/cluster/posts?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/cosmos/post3 credits

Post

Parameter	Type	Description
`url`required	string	Public Cosmos post URL.

curl "https://scrapeio.com/v1/cosmos/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/cosmos/profile3 credits

Profile

Parameter	Type	Description
`handle`required	string	Cosmos username without a profile URL.

curl "https://scrapeio.com/v1/cosmos/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/cosmos/search3 credits

Parameter	Type	Description
`query`required	string	Search text.
`cursor`	string	Pass the previous response cursor unchanged.

curl "https://scrapeio.com/v1/cosmos/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/cosmos/user/clusters3 credits

User Collections

Parameter	Type	Description
`handle`required	string	Cosmos username without a profile URL.
`cursor`	string	Pass the previous response cursor unchanged.

curl "https://scrapeio.com/v1/cosmos/user/clusters?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/cosmos/user/posts3 credits

User Posts

Parameter	Type	Description
`handle`required	string	Cosmos username without a profile URL.
`cursor`	string	Pass the previous response cursor unchanged.

curl "https://scrapeio.com/v1/cosmos/user/posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

Reddit7 endpoints

GET/v1/reddit/post3 credits

Post

Parameter	Type	Description
`url`required	string	Reddit post URL

curl "https://scrapeio.com/v1/reddit/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/reddit/post/comments3 credits

Post Comments

Parameter	Type	Description
`url`required	string	Reddit post URL
`trim`	boolean	Set to true for a trimmed down version of the response
`cursor`	string	One opaque cursor returned by the previous response to get more comments or replies.

curl "https://scrapeio.com/v1/reddit/post/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/reddit/post/transcript3 credits

Post Transcript

Parameter	Type	Description
`url`required	string	Reddit post URL or direct v.redd.it video URL
`language`	string	2 letter language code.
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/reddit/post/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/reddit/search3 credits

Parameter	Type	Description
`query`required	string	Search query
`filter`	posts, comments	Search posts or comments
`sort`	relevance, new, top, comment_count	Sort by.
`timeframe`	all, day, week, month, year	Post search timeframe
`trim`	boolean	Set to true for a trimmed down version of the response
`after`	string	Used to paginate to next page

curl "https://scrapeio.com/v1/reddit/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/reddit/subreddit3 credits

Subreddit Posts

Parameter	Type	Description
`subreddit`required	string	Subreddit name
`timeframe`	all, day, week, month, year	Timeframe to get posts from
`sort`	best, hot, new, top, rising	Sort order
`trim`	boolean	Set to true for a trimmed down version of the response
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca
`after`	string	After to get more posts.

curl "https://scrapeio.com/v1/reddit/subreddit?subreddit=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/reddit/subreddit/details3 credits

Subreddit Details

Parameter	Type	Description
`subreddit`	string	Subreddit name.
`url`	string	Subreddit URL
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/reddit/subreddit/details" \
  -H "x-api-key: YOUR_KEY"

GET/v1/reddit/subreddit/search3 credits

Subreddit Search

Parameter	Type	Description
`subreddit`required	string	Subreddit name (e.g.
`query`	string	Search query to find matching content
`sort`	relevance, hot, top, new, comments	Sort order.
`timeframe`	all, year, month, week, day, hour	Timeframe to filter results
`cursor`	string	Cursor to get more results.

curl "https://scrapeio.com/v1/reddit/subreddit/search?subreddit=..." \
  -H "x-api-key: YOUR_KEY"

Spotify7 endpoints

GET/v1/spotify/album3 credits

Album

Parameter	Type	Description
`id`	string	Spotify album id.
`url`	string	Spotify album URL.

curl "https://scrapeio.com/v1/spotify/album" \
  -H "x-api-key: YOUR_KEY"

GET/v1/spotify/artist3 credits

Artist

Parameter	Type	Description
`id`	string	Spotify artist id.
`url`	string	Spotify artist URL.

curl "https://scrapeio.com/v1/spotify/artist" \
  -H "x-api-key: YOUR_KEY"

GET/v1/spotify/playlist3 credits

Playlist

Parameter	Type	Description
`id`	string	Spotify playlist id.
`url`	string	Spotify playlist URL.
`cursor`	string	Cursor returned by the previous response.

curl "https://scrapeio.com/v1/spotify/playlist" \
  -H "x-api-key: YOUR_KEY"

GET/v1/spotify/podcast3 credits

Podcast

Parameter	Type	Description
`id`	string	Spotify podcast id.
`url`	string	Spotify podcast URL.

curl "https://scrapeio.com/v1/spotify/podcast" \
  -H "x-api-key: YOUR_KEY"

GET/v1/spotify/podcast/episodes3 credits

Podcast Episodes

Parameter	Type	Description
`id`	string	Spotify podcast id.
`url`	string	Spotify podcast URL.
`cursor`	string	Cursor returned by the previous response.

curl "https://scrapeio.com/v1/spotify/podcast/episodes" \
  -H "x-api-key: YOUR_KEY"

GET/v1/spotify/search3 credits

Parameter	Type	Description
`query`required	string	Search query

curl "https://scrapeio.com/v1/spotify/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/spotify/track3 credits

Track

Parameter	Type	Description
`id`	string	Spotify track id.
`url`	string	Spotify song URL.

curl "https://scrapeio.com/v1/spotify/track" \
  -H "x-api-key: YOUR_KEY"

LinkedIn6 endpoints

GET/v1/linkedin/company3 credits

Company Page

Parameter	Type	Description
`url`required	string	The URL of the LinkedIn company page to get

curl "https://scrapeio.com/v1/linkedin/company?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkedin/company/posts3 credits

Company Posts

Parameter	Type	Description
`url`required	string	The LinkedIn company (/company/) or school (/school/) page URL, for example https://www.linkedin.com/school/oxfordsbs/
`page`	string	The page number to get

curl "https://scrapeio.com/v1/linkedin/company/posts?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkedin/post3 credits

Post

Parameter	Type	Description
`url`required	string	The URL of the LinkedIn post to get

curl "https://scrapeio.com/v1/linkedin/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkedin/post/transcript3 credits

Post Transcript

Parameter	Type	Description
`url`required	string	The URL of the LinkedIn post to get the transcript from

curl "https://scrapeio.com/v1/linkedin/post/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkedin/profile3 credits

Person's Profile

Parameter	Type	Description
`url`required	string	The URL of the LinkedIn profile to get

curl "https://scrapeio.com/v1/linkedin/profile?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkedin/search/posts3 credits

Search Posts

Parameter	Type	Description
`query`required	string	Keyword or phrase to search for in public LinkedIn posts
`date_posted`	last-hour, last-day, last-week, last-month, last-year	Date posted filter based on Google-indexed results
`cursor`	string	The cursor returned from the previous response.

curl "https://scrapeio.com/v1/linkedin/search/posts?query=coffee" \
  -H "x-api-key: YOUR_KEY"

Facebook Ad Library5 endpoints

GET/v1/facebook/adLibrary/ad3 credits

Ad Details

Parameter	Type	Description
`id`	string	Facebook Ad Id
`url`	string	Facebook Ad URL
`allow_long_transcription`	boolean	Paid opt-in, enabled only by the literal query value 'true' (allowlongtranscription=true).
`get_transcript`	boolean	Transcription is opt-in via gettranscript=true.
`trim`	boolean	Set to true for a trimmed down version of the response
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/facebook/adLibrary/ad" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/ad/transcript3 credits

Ad Transcript

Parameter	Type	Description
`id`	string	Facebook Ad Id
`url`	string	Facebook Ad URL
`allow_long_transcription`	boolean	Paid opt-in, enabled only by the literal query value 'true' (allowlongtranscription=true).
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/facebook/adLibrary/ad/transcript" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/company/ads3 credits

Company Ads

Parameter	Type	Description
`pageId`	string	The companies ad library page id.
`companyName`	string	The name of the company.
`country`	string	This can only be one country.
`status`	ALL, ACTIVE, INACTIVE	Status of the ad.
`media_type`	ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE	Media type of the ad.
`language`	string	Language to filter ads on.
`sort_by`	total_impressions, relevancy_monthly_grouped	Sort by impressions (high to low), or Most Recent (relevancymonthlygrouped).
`start_date`	string	Start date to search for.
`end_date`	string	End date to search for.
`trim`	boolean	Set to true for a trimmed down version of the response
`cursor`	string	Cursor to paginate through results

curl "https://scrapeio.com/v1/facebook/adLibrary/company/ads" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/search/ads3 credits

Parameter	Type	Description
`query`required	string	Keyword to search for
`sort_by`	total_impressions, relevancy_monthly_grouped	Sort by impressions (high to low), or Most Recent (relevancymonthlygrouped).
`search_type`	keyword_unordered, keyword_exact_phrase	If you want to search by exact phrase or not
`ad_type`	all, political_and_issue_ads	Search for all ads or only political and issue ads
`country`	string	This can only be one country.
`language`	string	Language to filter ads on.
`status`	ALL, ACTIVE, INACTIVE	Status of the ad.
`media_type`	ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE	Media type of the ad.
`start_date`	string	Impressions start date.
`end_date`	string	Impressions end date.
`trim`	boolean	Set to true for a trimmed down version of the response
`cursor`	string	Cursor to paginate through results

curl "https://scrapeio.com/v1/facebook/adLibrary/search/ads?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/search/companies3 credits

Search for Companies

Parameter	Type	Description
`query`required	string	Keyword to search for

curl "https://scrapeio.com/v1/facebook/adLibrary/search/companies?query=coffee" \
  -H "x-api-key: YOUR_KEY"

Link in bio5 endpoints

GET/v1/linktree1 credit

A Linktree page: name, bio, avatar, every link and social icon.

Parameter	Type	Description
`url`required	string	Linktree URL or username.

curl "https://scrapeio.com/v1/linktree?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/komi3 credits

Komi page

Parameter	Type	Description
`url`required	string	URL to Komi page
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/komi?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkbio3 credits

Linkbio page

Parameter	Type	Description
`url`required	string	URL to Linkbio (lnk.bio) page
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/linkbio?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkme3 credits

Profile

Parameter	Type	Description
`url`required	string	Linkme profile URL
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/linkme?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/pillar3 credits

Pillar page

Parameter	Type	Description
`url`required	string	URL to Pillar page
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/pillar?url=..." \
  -H "x-api-key: YOUR_KEY"

Pinterest5 endpoints

GET/v1/pinterest/board1 credit

A board's details and its latest pins, with saves.

Parameter	Type	Description
`url`required	string	Board URL.

curl "https://scrapeio.com/v1/pinterest/board?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/pinterest/pin1 credit

One pin: image, description, outbound link, saves, board and author.

Parameter	Type	Description
`url`required	string	Pin URL.

curl "https://scrapeio.com/v1/pinterest/pin?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/pinterest/search3 credits

Parameter	Type	Description
`query`required	string	Search query
`trim`	boolean	Set to true for a trimmed down version of the response
`cursor`	string	Cursor

curl "https://scrapeio.com/v1/pinterest/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/pinterest/topic3 credits

Topic

Parameter	Type	Description
`url`required	string	The Pinterest ideas URL of the topic to get.

curl "https://scrapeio.com/v1/pinterest/topic?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/pinterest/user/boards3 credits

User Boards

Parameter	Type	Description
`handle`required	string	The username of the user to get boards for.
`trim`	boolean	Set to true for a trimmed down version of the response

curl "https://scrapeio.com/v1/pinterest/user/boards?handle=nike" \
  -H "x-api-key: YOUR_KEY"

Rumble5 endpoints

GET/v1/rumble/channel/videos3 credits

Channel Videos

Parameter	Type	Description
`handle`	string	Rumble channel handle.
`url`	string	Rumble channel URL.
`cursor`	string	Cursor from the previous response.

curl "https://scrapeio.com/v1/rumble/channel/videos" \
  -H "x-api-key: YOUR_KEY"

GET/v1/rumble/search3 credits

Parameter	Type	Description
`query`required	string	Search query.
`cursor`	string	Cursor from the previous response.

curl "https://scrapeio.com/v1/rumble/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/rumble/video3 credits

Video

Parameter	Type	Description
`url`required	string	Rumble video URL.

curl "https://scrapeio.com/v1/rumble/video?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/rumble/video/comments3 credits

Comments

Parameter	Type	Description
`url`required	string	Rumble video URL.

curl "https://scrapeio.com/v1/rumble/video/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/rumble/video/transcript3 credits

Transcript

Parameter	Type	Description
`url`required	string	Rumble video URL.

curl "https://scrapeio.com/v1/rumble/video/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

Threads5 endpoints

GET/v1/threads/post3 credits

Post

Parameter	Type	Description
`url`required	string	The URL of the post to get
`trim`	boolean	Set to true for a trimmed down version of the response
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/threads/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/threads/profile3 credits

Profile

Parameter	Type	Description
`handle`required	string	Threads username
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/threads/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/threads/search3 credits

Search by Keyword

Parameter	Type	Description
`query`required	string	Keyword to search for
`start_date`	string	Start date to search for
`end_date`	string	End date to search for
`trim`	boolean	Set to true for a trimmed down version of the response

curl "https://scrapeio.com/v1/threads/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/threads/search/users3 credits

Search Users

Parameter	Type	Description
`query`required	string	Username to search for

curl "https://scrapeio.com/v1/threads/search/users?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/threads/user/posts3 credits

Posts

Parameter	Type	Description
`handle`required	string	Threads username
`trim`	boolean	Set to true for a trimmed down version of the response

curl "https://scrapeio.com/v1/threads/user/posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

TikTok Shop5 endpoints

GET/v1/tiktok/product3 credits

Product Details

Parameter	Type	Description
`url`required	string	The URL of the product to get details for.
`region`	string	Region for the product details request.

curl "https://scrapeio.com/v1/tiktok/product?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/shop/product/reviews3 credits

Product Reviews

Parameter	Type	Description
`url`	string	The URL of the product (required if productid is not provided)
`product_id`	string	The ID of the product (required if url is not provided)
`region`	string	The region of the product.
`page`	string	The page number of the reviews

curl "https://scrapeio.com/v1/tiktok/shop/product/reviews" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/shop/products3 credits

Shop Products

Parameter	Type	Description
`url`required	string	The TikTok Shop store URL.
`sort_by`	top, new_releases	Sort products by best-selling items (top) or newest products (newreleases).
`region`	US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE	Region to get shop products from.
`cursor`	string	Cursor parameter from the previous response to retrieve the next page of products.

curl "https://scrapeio.com/v1/tiktok/shop/products?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/shop/search3 credits

Shop Search

Parameter	Type	Description
`query`required	string	Term you want to search for
`region`	US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE	Region to search shop products in.
`page`	string	Page number to retrieve

curl "https://scrapeio.com/v1/tiktok/shop/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/user/showcase3 credits

User Showcase

Parameter	Type	Description
`handle`required	string	The handle of the user
`region`	string	Region to put the proxy in.
`cursor`	string	The cursor to the next page of products

curl "https://scrapeio.com/v1/tiktok/user/showcase?handle=nike" \
  -H "x-api-key: YOUR_KEY"

Twitch5 endpoints

GET/v1/twitch/clip3 credits

Clip

Parameter	Type	Description
`url`required	string	Twitch clip URL
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/twitch/clip?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitch/clip/transcript3 credits

Clip Transcript

Parameter	Type	Description
`url`required	string	Twitch clip URL
`allow_long_transcription`	boolean	Paid opt-in, enabled only by the literal query value 'true' (allowlongtranscription=true).
`use_ai_as_fallback`	boolean	Use paid AI only when native captions are unavailable.

curl "https://scrapeio.com/v1/twitch/clip/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitch/profile3 credits

Profile

Parameter	Type	Description
`handle`required	string	Twitch handle
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/twitch/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitch/user/schedule3 credits

User Schedule

Parameter	Type	Description
`handle`required	string	Twitch handle

curl "https://scrapeio.com/v1/twitch/user/schedule?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/twitch/user/videos3 credits

User Videos

Parameter	Type	Description
`handle`required	string	Twitch handle
`filter_by`	HIGHLIGHT, ARCHIVE, UPLOAD	Filter by
`sort_by`	TIME, VIEWS	Sort by

curl "https://scrapeio.com/v1/twitch/user/videos?handle=nike" \
  -H "x-api-key: YOUR_KEY"

Apple Music4 endpoints

GET/v1/apple-music/album3 credits

Album

Parameter	Type	Description
`id`	string	Apple Music album id.
`url`	string	Apple Music album URL.

curl "https://scrapeio.com/v1/apple-music/album" \
  -H "x-api-key: YOUR_KEY"

GET/v1/apple-music/artist3 credits

Artist

Parameter	Type	Description
`id`	string	Apple Music artist id.
`url`	string	Apple Music artist URL.

curl "https://scrapeio.com/v1/apple-music/artist" \
  -H "x-api-key: YOUR_KEY"

GET/v1/apple-music/search3 credits

Parameter	Type	Description
`query`required	string	Search query
`type`	string	Result type to return.

curl "https://scrapeio.com/v1/apple-music/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/apple-music/track3 credits

Track

Parameter	Type	Description
`id`	string	Apple Music song id.
`url`	string	Apple Music song URL or album track URL.

curl "https://scrapeio.com/v1/apple-music/track" \
  -H "x-api-key: YOUR_KEY"

Bluesky3 endpoints

GET/v1/bluesky/profile1 credit

Bluesky profile: bio, avatar, followers, following, post count.

Parameter	Type	Description
`handle`required	string	Bluesky handle, e.g. bsky.app.

curl "https://scrapeio.com/v1/bluesky/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/bluesky/user/posts1 credit

A profile's posts, newest first, with likes, replies and reposts.

Send one of: handle, user_id.

Parameter	Type	Description
`handle`	string	Bluesky handle.
`user_id`	string	Bluesky DID. Send this or handle.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/bluesky/user/posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/bluesky/post1 credit

One Bluesky post with its stats and direct replies.

Parameter	Type	Description
`url`required	string	Bluesky post URL.

curl "https://scrapeio.com/v1/bluesky/post?url=..." \
  -H "x-api-key: YOUR_KEY"

Creator Tools3 endpoints

GET/v1/detect-age-gender3 credits

Get Age and Gender

Parameter	Type	Description
`url`required	string	URL to users social profile

curl "https://scrapeio.com/v1/detect-age-gender?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/find-creator-emailsup to 30 credits

Find Creator Emails

Parameter	Type	Description
`platform`required	instagram, tiktok, youtube, x, twitter, facebook	Source social platform
`handle`required	string	Creator handle without a profile URL.
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/find-creator-emails?platform=...&handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/find-social-profilesup to 30 credits

Find Social Profiles

Parameter	Type	Description
`platform`required	instagram, tiktok, youtube, x, twitter, facebook	Source social platform
`handle`required	string	Creator handle without a profile URL.
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/find-social-profiles?platform=...&handle=nike" \
  -H "x-api-key: YOUR_KEY"

Facebook Events3 endpoints

GET/v1/facebook/event/details3 credits

Event Details

Parameter	Type	Description
`id`	string	The ID of the event
`url`	string	The URL of the event

curl "https://scrapeio.com/v1/facebook/event/details" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/events3 credits

Events

Parameter	Type	Description
`url`required	string	The URL of the city's Facebook Events page
`time`	today, this_week, next_week	The time frame to search for.
`cursor`	string	The cursor to paginate to the next page

curl "https://scrapeio.com/v1/facebook/events?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/events/search3 credits

Search Events

Parameter	Type	Description
`query`required	string	The query to search for
`cursor`	string	The cursor to paginate to the next page

curl "https://scrapeio.com/v1/facebook/events/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

Facebook Marketplace3 endpoints

GET/v1/facebook/marketplace/item3 credits

Marketplace Item

Parameter	Type	Description
`id`	string	Facebook Marketplace item id
`url`	string	Facebook Marketplace item URL

curl "https://scrapeio.com/v1/facebook/marketplace/item" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/marketplace/location/search3 credits

Marketplace Location Search

Parameter	Type	Description
`query`required	string	Location search query

curl "https://scrapeio.com/v1/facebook/marketplace/location/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/marketplace/search3 credits

Marketplace Search

Parameter	Type	Description
`query`	string	Search keyword.
`lat`required	string	Latitude for the search location
`lng`required	string	Longitude for the search location
`category_id`	string	Category ID from listing results.
`radius_km`	string	Search radius in kilometers
`min_price`	string	Minimum listing price
`max_price`	string	Maximum listing price
`sort_by`	suggested, distance_ascend, creation_time_descend, price_ascend, price_descend	Facebook Marketplace sort option.
`delivery_method`	all, local_pickup, shipping	Delivery filter
`condition`	new, used_like_new, used_good, used_fair	Condition filter
`date_listed`	all, 1, 7, 30, last_24_hours, last_7_days, last_30_days	Facebook Marketplace date filter.
`availability`	available, sold, all	Availability filter
`cursor`	string	Opaque pagination cursor returned from the previous response.

curl "https://scrapeio.com/v1/facebook/marketplace/search?lat=...&lng=..." \
  -H "x-api-key: YOUR_KEY"

GitHub3 endpoints

GET/v1/github/user/contributions1 credit

A user's contribution calendar: count per day and the yearly total.

Send one of: handle, url.

Parameter	Type	Description
`handle`	string	GitHub username.
`url`	string	GitHub profile URL. Send this or handle.
`year`	string	Calendar year, e.g. 2025. Default: the last 12 months.

curl "https://scrapeio.com/v1/github/user/contributions?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/github/trending/repositories1 credit

GitHub's trending repositories, with stars gained in the period.

Parameter	Type	Description
`language`	string	Programming language, e.g. typescript.
`since`	string	daily, weekly or monthly.
`spoken_language_code`	string	Spoken language, e.g. en.

curl "https://scrapeio.com/v1/github/trending/repositories" \
  -H "x-api-key: YOUR_KEY"

GET/v1/github/trending/developers1 credit

GitHub's trending developers and their most popular repo.

Parameter	Type	Description
`language`	string	Programming language, e.g. rust.
`since`	string	daily, weekly or monthly.

curl "https://scrapeio.com/v1/github/trending/developers" \
  -H "x-api-key: YOUR_KEY"

Google Ad Library3 endpoints

GET/v1/google/ad3 credits

Ad Details

Parameter	Type	Description
`url`required	string	The url of the ad
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/google/ad?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/google/adLibrary/advertisers/search3 credits

Advertiser Search

Parameter	Type	Description
`query`required	string	The query to search for
`region`	string	2-letter country code to search in.

curl "https://scrapeio.com/v1/google/adLibrary/advertisers/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/google/company/adsup to 75 credits

Company Ads

Parameter	Type	Description
`domain`	string	The domain of the company
`advertiser_id`	string	The advertiser id of the company
`topic`	all, political	The topic to search for.
`region`	string	The region to search for.
`start_date`	string	Start date to search for.
`end_date`	string	End date to search for.
`platform`	google_maps, google_play, google_search, google_shopping, youtube	Platform to search for.
`format`	text, image, video	Ad format to search for.
`get_ad_details`	string	Set to true to get the ad details.
`cursor`	string	Cursor to paginate through results

curl "https://scrapeio.com/v1/google/company/ads" \
  -H "x-api-key: YOUR_KEY"

Kwai3 endpoints

GET/v1/kwai/post3 credits

Post

Parameter	Type	Description
`url`	string	Kwai post URL

curl "https://scrapeio.com/v1/kwai/post" \
  -H "x-api-key: YOUR_KEY"

GET/v1/kwai/profile3 credits

Profile

Parameter	Type	Description
`handle`	string	Kwai profile handle.
`url`	string	Kwai profile URL.

curl "https://scrapeio.com/v1/kwai/profile" \
  -H "x-api-key: YOUR_KEY"

GET/v1/kwai/user/posts3 credits

User Posts

Parameter	Type	Description
`handle`	string	Kwai profile handle.
`url`	string	Kwai profile URL.
`count`	string	Number of posts to return, max 50
`cursor`	string	Cursor from the previous response for the next page

curl "https://scrapeio.com/v1/kwai/user/posts" \
  -H "x-api-key: YOUR_KEY"

Snapchat3 endpoints

GET/v1/snapchat/profile1 credit

A Snapchat public profile: name, bio, subscribers, category.

Parameter	Type	Description
`handle`required	string	Snapchat username.

curl "https://scrapeio.com/v1/snapchat/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/snapchat/spotlight3 credits

Spotlight by Link

Parameter	Type	Description
`url`required	string	Snapchat Spotlight URL.

curl "https://scrapeio.com/v1/snapchat/spotlight?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/snapchat/spotlight/comments3 credits

Spotlight Comments by Link

Parameter	Type	Description
`url`required	string	Snapchat Spotlight URL.
`cursor`	string	Pagination cursor from the previous response.

curl "https://scrapeio.com/v1/snapchat/spotlight/comments?url=..." \
  -H "x-api-key: YOUR_KEY"

SoundCloud3 endpoints

GET/v1/soundcloud/artist3 credits

Artist

Parameter	Type	Description
`handle`	string	SoundCloud artist handle.
`url`	string	SoundCloud artist URL.

curl "https://scrapeio.com/v1/soundcloud/artist" \
  -H "x-api-key: YOUR_KEY"

GET/v1/soundcloud/artist/tracks3 credits

Artist Tracks

Parameter	Type	Description
`handle`	string	SoundCloud artist handle.
`url`	string	SoundCloud artist tracks URL.
`cursor`	string	Cursor to get more tracks.

curl "https://scrapeio.com/v1/soundcloud/artist/tracks" \
  -H "x-api-key: YOUR_KEY"

GET/v1/soundcloud/track3 credits

Track

Parameter	Type	Description
`url`required	string	SoundCloud track URL.

curl "https://scrapeio.com/v1/soundcloud/track?url=..." \
  -H "x-api-key: YOUR_KEY"

Telegram3 endpoints

GET/v1/telegram/channel1 credit

A public channel: name, description, subscribers, media counts.

Parameter	Type	Description
`handle`required	string	Channel handle, @handle or t.me URL.

curl "https://scrapeio.com/v1/telegram/channel?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/telegram/channel/posts1 credit

A public channel's latest posts with views, newest first.

Parameter	Type	Description
`handle`required	string	Channel handle, @handle or t.me URL.
`cursor`	string	Cursor from the previous page's data.cursor.

curl "https://scrapeio.com/v1/telegram/channel/posts?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/telegram/post1 credit

One public channel post with its text, media and views.

Parameter	Type	Description
`url`required	string	Post URL, e.g. https://t.me/durov/123.

curl "https://scrapeio.com/v1/telegram/post?url=..." \
  -H "x-api-key: YOUR_KEY"

Truth Social3 endpoints

GET/v1/truthsocial/post3 credits

Post

Parameter	Type	Description
`url`required	string	Truth Social post URL
`download_media`	boolean	Set to true to download the attached video/images and get back permanent Supabase URLs.

curl "https://scrapeio.com/v1/truthsocial/post?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/truthsocial/profile3 credits

Profile

Parameter	Type	Description
`handle`required	string	Truth Social username

curl "https://scrapeio.com/v1/truthsocial/profile?handle=nike" \
  -H "x-api-key: YOUR_KEY"

GET/v1/truthsocial/user/posts3 credits

User Posts

Parameter	Type	Description
`handle`	string	Truth Social username
`user_id`	string	Truth Social user id.
`trim`	boolean	Set to true for a trimmed down version of the response
`next_max_id`	string	Used to paginate to next page

curl "https://scrapeio.com/v1/truthsocial/user/posts" \
  -H "x-api-key: YOUR_KEY"

Kick2 endpoints

GET/v1/kick/clip3 credits

Clip

Parameter	Type	Description
`url`required	string	Kick clip URL

curl "https://scrapeio.com/v1/kick/clip?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/kick/clip/transcript3 credits

Clip Transcript

Parameter	Type	Description
`url`required	string	Kick clip URL
`allow_long_transcription`	boolean	Paid opt-in, enabled only by the literal query value 'true' (allowlongtranscription=true).
`use_ai_as_fallback`	boolean	Use paid AI only when native captions are unavailable.

curl "https://scrapeio.com/v1/kick/clip/transcript?url=..." \
  -H "x-api-key: YOUR_KEY"

LinkedIn Ad Library2 endpoints

GET/v1/linkedin/ad3 credits

Ad Details

Parameter	Type	Description
`url`required	string	The url of the ad

curl "https://scrapeio.com/v1/linkedin/ad?url=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/linkedin/ads/search3 credits

Search Ads

Parameter	Type	Description
`company`	string	The company name to search for.
`keyword`	string	The keyword to search for
`companyId`	string	The company id to search for
`countries`	string	Comma separated list of countries.
`startDate`	string	Start date in YYYY-MM-DD format.
`endDate`	string	End date in YYYY-MM-DD format.
`paginationToken`	string	Pagination token to paginate through results

curl "https://scrapeio.com/v1/linkedin/ads/search" \
  -H "x-api-key: YOUR_KEY"

TikTok Ad Library2 endpoints

GET/v1/tiktok/ad-library/ad3 credits

Ad Library Ad

Parameter	Type	Description
`ad_id`required	string	Creative Center Top Ads material ID or URL, or a public Ads Library ad ID or library.tiktok.com detail URL.

curl "https://scrapeio.com/v1/tiktok/ad-library/ad?ad_id=..." \
  -H "x-api-key: YOUR_KEY"

GET/v1/tiktok/ad-library/search3 credits

Ad Library Search

Parameter	Type	Description
`query`	string	General ad search.
`advertiser_name`	string	Advertiser name to resolve through TikTok's typeahead and search by advertiser entity.
`adv_biz_ids`	string	TikTok advertiser business ID from a See all ads link.
`cursor`	string	Opaque cursor returned from the previous response.

curl "https://scrapeio.com/v1/tiktok/ad-library/search" \
  -H "x-api-key: YOUR_KEY"

Amazon Shop1 endpoint

GET/v1/amazon/shop3 credits

Amazon Shop page

Parameter	Type	Description
`url`required	string	URL to Amazon Shop page
`pageToken`	string	Opaque page token returned by a previous response for the same shop URL.

curl "https://scrapeio.com/v1/amazon/shop?url=..." \
  -H "x-api-key: YOUR_KEY"

Google Search1 endpoint

GET/v1/google/search3 credits

Parameter	Type	Description
`query`required	string	Search query
`region`	string	2 letter country code, ie US, UK, CA, etc This will show results from that country
`date_posted`	last-hour, last-day, last-week, last-month, last-year	Date posted
`page`	string	Page number to retrieve.

curl "https://scrapeio.com/v1/google/search?query=coffee" \
  -H "x-api-key: YOUR_KEY"

Parameter	Type	Description
`url`required	string	Community URL.
`cursor`	string	Cursor from the previous page's data.cursor.

Parameter	Type	Description
`url`required	string	Tweet URL
`allow_long_transcription`	boolean	Paid opt-in, enabled only by the literal query value 'true' (allowlongtranscription=true).
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca