# ScrapeIO

> One API for public social media data: profiles, posts, comments, transcripts, search, trends and ad libraries from 33 platforms (194 endpoints). Same field names everywhere, backup sources when one fails, pay only for answers.

## For agents

- [Full reference](https://scrapeio.com/llms-full.txt): every endpoint with parameters, price and an example call, in one Markdown file. Read this before writing code.
- [OpenAPI](https://scrapeio.com/openapi.json): machine-readable schema.
- [MCP server](https://scrapeio.com/mcp): Streamable HTTP. Every endpoint is a tool. Send `x-api-key`.
- [Agent skill](https://scrapeio.com/skill.md): drop-in SKILL.md for Claude Code, Codex and other agents.
- [AGENTS.md snippet](https://scrapeio.com/agents.md): paste into a repo so coding agents use the API correctly.
- [Docs](https://scrapeio.com/docs) · [Pricing](https://scrapeio.com/pricing)

## Basics

- Base URL: `https://scrapeio.com`
- Auth: send your key in the `x-api-key` header. Get a key at https://scrapeio.com/login (100 free credits, no card).
- Every endpoint is a GET with query parameters and returns JSON:
  `{ "success": true, "cached": false, "credits_used": 1, "credits_remaining": 99, "data": { ... } }`
- Field names are the same on every platform (`handle`, `followers`, `plays`, `likes`, `comments`, `created_at`).
- Lists return `data.items`, `data.cursor` and `data.has_more`. Pass `cursor` back to get the next page.
- Each endpoint has one listed price. Cached repeats, failed calls, private and not-found answers cost 0.
- Limit: 300 requests a minute per key.

## Errors

| 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 |

## Endpoints

### TikTok

Full reference: https://scrapeio.com/platforms/tiktok.md

- `GET /v1/tiktok/profile`: TikTok profile: bio, avatar, followers, following, likes, video count. (1 credit)
- `GET /v3/tiktok/profile/videos`: A profile's videos, newest first, with plays, likes, comments, shares and saves. (1 credit)
- `GET /v2/tiktok/video`: One TikTok video by URL: stats, caption, author, music, download URL. (5 credits)
- `GET /v1/tiktok/video/transcript`: Spoken-word transcript of a TikTok video, from its captions. (5 credits)
- `GET /v1/tiktok/video/comments`: Comments on a TikTok video, most liked first. (1 credit)
- `GET /v1/tiktok/video/comment/replies`: Replies to one TikTok comment. (1 credit)
- `GET /v1/tiktok/search/keyword`: Search TikTok videos by keyword. (5 credits)
- `GET /v1/tiktok/search/users`: Search TikTok accounts by keyword. (5 credits)
- `GET /v1/tiktok/search/hashtag`: Videos under a hashtag, plus the hashtag's totals. (5 credits)
- `GET /v1/tiktok/trending`: Trending feed for a region. (5 credits)
- `GET /v1/tiktok/user/followers`: A profile's followers, newest first. (5 credits)
- `GET /v1/tiktok/user/liked`: Videos a profile has liked (when public). (1 credit)
- `GET /v1/tiktok/song`: A TikTok sound: title, author, duration, usage count. (5 credits)
- `GET /v1/tiktok/song/videos`: Videos that use a sound. (5 credits)
- `GET /v1/tiktok/collection/videos`: Collection Videos (5 credits)
- `GET /v1/tiktok/get-trending-feed`: Trending Feed (5 credits)
- `GET /v1/tiktok/live`: Live Info (5 credits)
- `GET /v1/tiktok/profile/region`: Profile Region (5 credits)
- `GET /v1/tiktok/search/suggestions`: Search Suggestions (5 credits)
- `GET /v1/tiktok/search/top`: Top Search (5 credits)
- `GET /v1/tiktok/user/audience`: User's Audience Demographics (up to 130 credits)
- `GET /v1/tiktok/user/following`: Following (5 credits)
- `GET /v1/tiktok/user/live`: Live (5 credits)

### Instagram

Full reference: https://scrapeio.com/platforms/instagram.md

- `GET /v1/instagram/profile`: Instagram profile: bio, avatar, followers, following, post count, category. (1 credit)
- `GET /v2/instagram/user/posts`: A profile's posts of every type (reels, photos, carousels), newest first, with real play counts. (5 credits)
- `GET /v1/instagram/user/reels`: A profile's reels with real play counts. (1 credit)
- `GET /v1/instagram/post`: One post or reel by URL: plays, likes, comments, caption, media URLs. (5 credits)
- `GET /v2/instagram/post/comments`: Comments on a post or reel. (1 credit)
- `GET /v1/instagram/post/comment/replies`: Replies to one Instagram comment. (1 credit)
- `GET /v2/instagram/media/transcript`: Transcript of a reel (videos under 2 minutes). (5 credits)
- `GET /v1/instagram/search`: Search Instagram accounts and hashtags. (1 credit)
- `GET /v1/instagram/search/posts`: Search Instagram posts and reels by keyword. (1 credit)
- `GET /v1/instagram/hashtag`: Recent posts under a hashtag. (1 credit)
- `GET /v1/instagram/user/similar`: Accounts Instagram suggests as similar to a profile. (1 credit)
- `GET /v1/instagram/user/highlights`: A profile's story highlights: id, title, cover. (1 credit)
- `GET /v1/instagram/user/highlight/detail`: The stories inside one highlight, with image and video links. (1 credit)
- `GET /v1/instagram/profile/post-count`: How many posts a profile has. (1 credit)
- `GET /v1/instagram/search/profiles`: Search Instagram accounts by keyword. (1 credit)
- `GET /v1/instagram/user/tagged-posts`: Posts other accounts tagged a profile in. (1 credit)
- `GET /v1/instagram/search/hashtag`: Recent posts under an Instagram hashtag. (1 credit)
- `GET /v1/instagram/audio/reels`: Get Reels By Audio Id (5 credits)
- `GET /v1/instagram/basic-profile`: Basic Profile (5 credits)
- `GET /v1/instagram/reels/trending`: Trending Reels (5 credits)
- `GET /v1/instagram/search/popular`: Popular Search (5 credits)
- `GET /v1/instagram/user/embed`: Embed HTML (5 credits)
- `GET /v2/instagram/reels/search`: Search Reels (5 credits)

### YouTube

Full reference: https://scrapeio.com/platforms/youtube.md

- `GET /v1/youtube/channel`: YouTube channel: subscribers, total views, video count, description. (1 credit)
- `GET /v1/youtube/channel-videos`: A channel's uploads (videos and Shorts), newest first, with views, likes and comments. (1 credit)
- `GET /v1/youtube/video`: One YouTube video or Short by URL: views, likes, comments, duration, tags. (1 credit)
- `GET /v1/youtube/video/comments`: Comments on a YouTube video. (1 credit)
- `GET /v1/youtube/search`: Search YouTube videos with full stats. (2 credits)
- `GET /v1/youtube/video/download`: Direct MP4 stream URLs for a video (360p with audio, plus every format). (2 credits)
- `GET /v1/youtube/playlist`: A playlist's details and its videos, with views and likes. (1 credit)
- `GET /v1/youtube/channel/playlists`: A channel's public playlists. (1 credit)
- `GET /v1/youtube/channel/shorts`: A channel's Shorts, newest first, with views and likes. (1 credit)
- `GET /v1/youtube/channel/lives`: A channel's past and current live streams. (1 credit)
- `GET /v1/youtube/video/comment/replies`: Replies to one YouTube comment. (1 credit)
- `GET /v1/youtube/search/typeahead`: Search suggestions YouTube shows as you type. (1 credit)
- `GET /v1/youtube/channel/community-posts`: A channel's community posts: text, images, polls, likes and comments. (1 credit)
- `GET /v1/youtube/community-post`: One community post with its text, images and likes. (1 credit)
- `GET /v1/youtube/channel/search`: Search inside one channel's videos. (1 credit)
- `GET /v1/youtube/search/hashtag`: Videos under a YouTube hashtag, with views and length. (1 credit)
- `GET /v1/youtube/shorts/trending`: Trending Shorts (5 credits)
- `GET /v1/youtube/video/sponsors`: Video Sponsors (5 credits)
- `GET /v1/youtube/video/transcript`: Transcript (5 credits)

### X (Twitter)

Full reference: https://scrapeio.com/platforms/x-twitter.md

- `GET /v1/twitter/profile`: X profile: bio, avatar, followers, following, post count. (1 credit)
- `GET /v1/twitter/user-tweets`: A profile's posts, newest first, with views, likes, reposts, replies and bookmarks. (1 credit)
- `GET /v1/twitter/tweet`: One post by URL or id. (1 credit)
- `GET /v1/twitter/tweet/replies`: Latest replies to a post. (1 credit)
- `GET /v1/twitter/search`: Search X posts. X search operators work. (1 credit)
- `GET /v1/twitter/trends`: Trending topics for a country. (1 credit)
- `GET /v1/twitter/community`: An X community: name, description, topic, member count and rules. (1 credit)
- `GET /v1/twitter/community/tweets`: Latest posts in an X community, with views and likes. (1 credit)
- `GET /v1/twitter/search/posts`: X's Top results for a keyword, with views and likes. (1 credit)
- `GET /v1/twitter/tweet/transcript`: Transcript (5 credits)

### Facebook

Full reference: https://scrapeio.com/platforms/facebook.md

- `GET /v1/facebook/profile`: Facebook profile or Page: name, avatar, followers, category. (5 credits)
- `GET /v1/facebook/profile/posts`: Posts from a profile or Page with reactions, comments and shares. (5 credits)
- `GET /v1/facebook/profile/reels`: Videos and reels from a profile or Page with view counts. (5 credits)
- `GET /v1/facebook/post`: One Facebook post, video or reel by URL: views, reactions, comments, shares, video URL. (5 credits)
- `GET /v1/facebook/post/comments`: Top-level comments on a Facebook post or video. (5 credits)
- `GET /v1/facebook/group`: Facebook Group Info (5 credits)
- `GET /v1/facebook/group/posts`: Facebook Group Posts (5 credits)
- `GET /v1/facebook/post/comment/replies`: Comment Replies (5 credits)
- `GET /v1/facebook/post/transcript`: Transcript (5 credits)
- `GET /v1/facebook/profile/events`: Profile Events (5 credits)
- `GET /v1/facebook/profile/photos`: Profile Photos (5 credits)
- `GET /v1/facebook/search/videos`: Search Videos (5 credits)

### Cosmos

Full reference: https://scrapeio.com/platforms/cosmos.md

- `GET /v1/cosmos/cluster`: Collection (5 credits)
- `GET /v1/cosmos/cluster/posts`: Collection Posts (5 credits)
- `GET /v1/cosmos/post`: Post (5 credits)
- `GET /v1/cosmos/profile`: Profile (5 credits)
- `GET /v1/cosmos/search`: Search (5 credits)
- `GET /v1/cosmos/user/clusters`: User Collections (5 credits)
- `GET /v1/cosmos/user/posts`: User Posts (5 credits)

### Reddit

Full reference: https://scrapeio.com/platforms/reddit.md

- `GET /v1/reddit/post`: Post (5 credits)
- `GET /v1/reddit/post/comments`: Post Comments (5 credits)
- `GET /v1/reddit/post/transcript`: Post Transcript (5 credits)
- `GET /v1/reddit/search`: Search (5 credits)
- `GET /v1/reddit/subreddit`: Subreddit Posts (5 credits)
- `GET /v1/reddit/subreddit/details`: Subreddit Details (5 credits)
- `GET /v1/reddit/subreddit/search`: Subreddit Search (5 credits)

### Spotify

Full reference: https://scrapeio.com/platforms/spotify.md

- `GET /v1/spotify/album`: Album (5 credits)
- `GET /v1/spotify/artist`: Artist (5 credits)
- `GET /v1/spotify/playlist`: Playlist (5 credits)
- `GET /v1/spotify/podcast`: Podcast (5 credits)
- `GET /v1/spotify/podcast/episodes`: Podcast Episodes (5 credits)
- `GET /v1/spotify/search`: Search (5 credits)
- `GET /v1/spotify/track`: Track (5 credits)

### LinkedIn

Full reference: https://scrapeio.com/platforms/linkedin.md

- `GET /v1/linkedin/company`: Company Page (5 credits)
- `GET /v1/linkedin/company/posts`: Company Posts (5 credits)
- `GET /v1/linkedin/post`: Post (5 credits)
- `GET /v1/linkedin/post/transcript`: Post Transcript (5 credits)
- `GET /v1/linkedin/profile`: Person's Profile (5 credits)
- `GET /v1/linkedin/search/posts`: Search Posts (5 credits)

### Facebook Ad Library

Full reference: https://scrapeio.com/platforms/facebook-ad-library.md

- `GET /v1/facebook/adLibrary/ad`: Ad Details (5 credits)
- `GET /v1/facebook/adLibrary/ad/transcript`: Ad Transcript (5 credits)
- `GET /v1/facebook/adLibrary/company/ads`: Company Ads (5 credits)
- `GET /v1/facebook/adLibrary/search/ads`: Search (5 credits)
- `GET /v1/facebook/adLibrary/search/companies`: Search for Companies (5 credits)

### Link in bio

Full reference: https://scrapeio.com/platforms/link-in-bio.md

- `GET /v1/linktree`: A Linktree page: name, bio, avatar, every link and social icon. (1 credit)
- `GET /v1/komi`: Komi page (5 credits)
- `GET /v1/linkbio`: Linkbio page (5 credits)
- `GET /v1/linkme`: Profile (5 credits)
- `GET /v1/pillar`: Pillar page (5 credits)

### Pinterest

Full reference: https://scrapeio.com/platforms/pinterest.md

- `GET /v1/pinterest/board`: A board's details and its latest pins, with saves. (1 credit)
- `GET /v1/pinterest/pin`: One pin: image, description, outbound link, saves, board and author. (1 credit)
- `GET /v1/pinterest/search`: Search (5 credits)
- `GET /v1/pinterest/topic`: Topic (5 credits)
- `GET /v1/pinterest/user/boards`: User Boards (5 credits)

### Rumble

Full reference: https://scrapeio.com/platforms/rumble.md

- `GET /v1/rumble/channel/videos`: Channel Videos (5 credits)
- `GET /v1/rumble/search`: Search (5 credits)
- `GET /v1/rumble/video`: Video (5 credits)
- `GET /v1/rumble/video/comments`: Comments (5 credits)
- `GET /v1/rumble/video/transcript`: Transcript (5 credits)

### Threads

Full reference: https://scrapeio.com/platforms/threads.md

- `GET /v1/threads/post`: Post (5 credits)
- `GET /v1/threads/profile`: Profile (5 credits)
- `GET /v1/threads/search`: Search by Keyword (5 credits)
- `GET /v1/threads/search/users`: Search Users (5 credits)
- `GET /v1/threads/user/posts`: Posts (5 credits)

### TikTok Shop

Full reference: https://scrapeio.com/platforms/tiktok-shop.md

- `GET /v1/tiktok/product`: Product Details (5 credits)
- `GET /v1/tiktok/shop/product/reviews`: Product Reviews (5 credits)
- `GET /v1/tiktok/shop/products`: Shop Products (5 credits)
- `GET /v1/tiktok/shop/search`: Shop Search (5 credits)
- `GET /v1/tiktok/user/showcase`: User Showcase (5 credits)

### Twitch

Full reference: https://scrapeio.com/platforms/twitch.md

- `GET /v1/twitch/clip`: Clip (5 credits)
- `GET /v1/twitch/clip/transcript`: Clip Transcript (5 credits)
- `GET /v1/twitch/profile`: Profile (5 credits)
- `GET /v1/twitch/user/schedule`: User Schedule (5 credits)
- `GET /v1/twitch/user/videos`: User Videos (5 credits)

### Apple Music

Full reference: https://scrapeio.com/platforms/apple-music.md

- `GET /v1/apple-music/album`: Album (5 credits)
- `GET /v1/apple-music/artist`: Artist (5 credits)
- `GET /v1/apple-music/search`: Search (5 credits)
- `GET /v1/apple-music/track`: Track (5 credits)

### Bluesky

Full reference: https://scrapeio.com/platforms/bluesky.md

- `GET /v1/bluesky/profile`: Bluesky profile: bio, avatar, followers, following, post count. (1 credit)
- `GET /v1/bluesky/user/posts`: A profile's posts, newest first, with likes, replies and reposts. (1 credit)
- `GET /v1/bluesky/post`: One Bluesky post with its stats and direct replies. (1 credit)

### Creator Tools

Full reference: https://scrapeio.com/platforms/creator-tools.md

- `GET /v1/detect-age-gender`: Get Age and Gender (5 credits)
- `GET /v1/find-creator-emails`: Find Creator Emails (up to 50 credits)
- `GET /v1/find-social-profiles`: Find Social Profiles (up to 50 credits)

### Facebook Events

Full reference: https://scrapeio.com/platforms/facebook-events.md

- `GET /v1/facebook/event/details`: Event Details (5 credits)
- `GET /v1/facebook/events`: Events (5 credits)
- `GET /v1/facebook/events/search`: Search Events (5 credits)

### Facebook Marketplace

Full reference: https://scrapeio.com/platforms/facebook-marketplace.md

- `GET /v1/facebook/marketplace/item`: Marketplace Item (5 credits)
- `GET /v1/facebook/marketplace/location/search`: Marketplace Location Search (5 credits)
- `GET /v1/facebook/marketplace/search`: Marketplace Search (5 credits)

### GitHub

Full reference: https://scrapeio.com/platforms/github.md

- `GET /v1/github/user/contributions`: A user's contribution calendar: count per day and the yearly total. (1 credit)
- `GET /v1/github/trending/repositories`: GitHub's trending repositories, with stars gained in the period. (1 credit)
- `GET /v1/github/trending/developers`: GitHub's trending developers and their most popular repo. (1 credit)

### Google Ad Library

Full reference: https://scrapeio.com/platforms/google-ad-library.md

- `GET /v1/google/ad`: Ad Details (5 credits)
- `GET /v1/google/adLibrary/advertisers/search`: Advertiser Search (5 credits)
- `GET /v1/google/company/ads`: Company Ads (up to 125 credits)

### Kwai

Full reference: https://scrapeio.com/platforms/kwai.md

- `GET /v1/kwai/post`: Post (5 credits)
- `GET /v1/kwai/profile`: Profile (5 credits)
- `GET /v1/kwai/user/posts`: User Posts (5 credits)

### Snapchat

Full reference: https://scrapeio.com/platforms/snapchat.md

- `GET /v1/snapchat/profile`: A Snapchat public profile: name, bio, subscribers, category. (1 credit)
- `GET /v1/snapchat/spotlight`: Spotlight by Link (5 credits)
- `GET /v1/snapchat/spotlight/comments`: Spotlight Comments by Link (5 credits)

### SoundCloud

Full reference: https://scrapeio.com/platforms/soundcloud.md

- `GET /v1/soundcloud/artist`: Artist (5 credits)
- `GET /v1/soundcloud/artist/tracks`: Artist Tracks (5 credits)
- `GET /v1/soundcloud/track`: Track (5 credits)

### Telegram

Full reference: https://scrapeio.com/platforms/telegram.md

- `GET /v1/telegram/channel`: A public channel: name, description, subscribers, media counts. (1 credit)
- `GET /v1/telegram/channel/posts`: A public channel's latest posts with views, newest first. (1 credit)
- `GET /v1/telegram/post`: One public channel post with its text, media and views. (1 credit)

### Truth Social

Full reference: https://scrapeio.com/platforms/truth-social.md

- `GET /v1/truthsocial/post`: Post (5 credits)
- `GET /v1/truthsocial/profile`: Profile (5 credits)
- `GET /v1/truthsocial/user/posts`: User Posts (5 credits)

### Kick

Full reference: https://scrapeio.com/platforms/kick.md

- `GET /v1/kick/clip`: Clip (5 credits)
- `GET /v1/kick/clip/transcript`: Clip Transcript (5 credits)

### LinkedIn Ad Library

Full reference: https://scrapeio.com/platforms/linkedin-ad-library.md

- `GET /v1/linkedin/ad`: Ad Details (5 credits)
- `GET /v1/linkedin/ads/search`: Search Ads (5 credits)

### TikTok Ad Library

Full reference: https://scrapeio.com/platforms/tiktok-ad-library.md

- `GET /v1/tiktok/ad-library/ad`: Ad Library Ad (5 credits)
- `GET /v1/tiktok/ad-library/search`: Ad Library Search (5 credits)

### Amazon Shop

Full reference: https://scrapeio.com/platforms/amazon-shop.md

- `GET /v1/amazon/shop`: Amazon Shop page (5 credits)

### Google Search

Full reference: https://scrapeio.com/platforms/google-search.md

- `GET /v1/google/search`: Search (5 credits)