# ScrapeIO API reference

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

## TikTok

### GET /v1/tiktok/profile

TikTok profile: bio, avatar, followers, following, likes, video count. Price: 1 credit. MCP tool: `tiktok_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok username, with or without @. |

```bash
curl "https://scrapeio.com/v1/tiktok/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v3/tiktok/profile/videos

A profile's videos, newest first, with plays, likes, comments, shares and saves. Price: 1 credit. MCP tool: `tiktok_profile_videos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v3/tiktok/profile/videos?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v2/tiktok/video

One TikTok video by URL: stats, caption, author, music, download URL. Price: 1 credit. MCP tool: `tiktok_video`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | TikTok video URL. |

```bash
curl "https://scrapeio.com/v2/tiktok/video?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/video/transcript

Spoken-word transcript of a TikTok video, from its captions. Price: 1 credit. MCP tool: `tiktok_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | TikTok video URL. |
| `language` | string | no | Preferred language code, e.g. en. |

```bash
curl "https://scrapeio.com/v1/tiktok/video/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/video/comments

Comments on a TikTok video, most liked first. Price: 1 credit. MCP tool: `tiktok_comments`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | TikTok video URL. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/video/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/video/comment/replies

Replies to one TikTok comment. Price: 1 credit. MCP tool: `tiktok_comment_replies`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/video/comment/replies?url=...&comment_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/search/keyword

Search TikTok videos by keyword. Price: 1 credit. MCP tool: `tiktok_search_keyword`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/search/keyword?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/search/users

Search TikTok accounts by keyword. Price: 1 credit. MCP tool: `tiktok_search_users`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/search/users?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/search/hashtag

Videos under a hashtag, plus the hashtag's totals. Price: 1 credit. MCP tool: `tiktok_search_hashtag`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hashtag` | string | yes | Hashtag, with or without #. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/search/hashtag?hashtag=travel" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/trending

Trending feed for a region. Price: 1 credit. MCP tool: `tiktok_trending`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `region` | string | no | Two-letter country code. |

```bash
curl "https://scrapeio.com/v1/tiktok/trending" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/user/followers

A profile's followers, newest first. Price: 1 credit. MCP tool: `tiktok_followers`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/user/followers?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/user/liked

Videos a profile has liked (when public). Price: 1 credit. MCP tool: `tiktok_liked_videos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/user/liked?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/song

A TikTok sound: title, author, duration, usage count. Price: 1 credit. MCP tool: `tiktok_song`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | TikTok sound or video URL. |

```bash
curl "https://scrapeio.com/v1/tiktok/song?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/song/videos

Videos that use a sound. Price: 1 credit. MCP tool: `tiktok_song_videos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `music_id` | string | yes | Sound id from the song endpoint. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/song/videos?music_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/user/following

Accounts a TikTok profile follows. Price: 1 credit. MCP tool: `tiktok_following`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/tiktok/user/following?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/get-trending-feed

TikTok's trending feed for a country. Price: 1 credit. MCP tool: `tiktok_trending_feed`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `region` | string | no | Two-letter country code. |

```bash
curl "https://scrapeio.com/v1/tiktok/get-trending-feed" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/collection/videos

Collection Videos Price: 1 credit. MCP tool: `tiktok_collection_videos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Public TikTok collection URL |
| `cursor` | string | no | Cursor to get more videos. |

```bash
curl "https://scrapeio.com/v1/tiktok/collection/videos?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/live

Live Info Price: 1 credit. MCP tool: `tiktok_live`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `room_id` | string | yes | TikTok live room id. |
| `user_id` | string | yes | TikTok numeric user id for the live owner. |

```bash
curl "https://scrapeio.com/v1/tiktok/live?room_id=...&user_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/profile/region

Profile Region Price: 1 credit. MCP tool: `tiktok_profile_region`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok handle |

```bash
curl "https://scrapeio.com/v1/tiktok/profile/region?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/search/suggestions

Search Suggestions Price: 1 credit. MCP tool: `tiktok_search_suggestions`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search query to get suggestions for |
| `region` | string | no | Region code for suggestions |

```bash
curl "https://scrapeio.com/v1/tiktok/search/suggestions?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/search/top

Top Search Price: 1 credit. MCP tool: `tiktok_search_top`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/search/top?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/user/audience

User's Audience Demographics Price: up to 26 credits. MCP tool: `tiktok_user_audience`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok handle |

```bash
curl "https://scrapeio.com/v1/tiktok/user/audience?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/user/live

Live Price: 1 credit. MCP tool: `tiktok_user_live`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | TikTok handle |

```bash
curl "https://scrapeio.com/v1/tiktok/user/live?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Instagram

### GET /v1/instagram/profile

Instagram profile: bio, avatar, followers, following, post count, category. Price: 1 credit. MCP tool: `instagram_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Instagram username, with or without @. |

```bash
curl "https://scrapeio.com/v1/instagram/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v2/instagram/user/posts

A profile's posts of every type (reels, photos, carousels), newest first, with real play counts. Price: 1 credit. MCP tool: `instagram_user_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Instagram username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v2/instagram/user/posts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/user/reels

A profile's reels with real play counts. Price: 1 credit. MCP tool: `instagram_user_reels`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Instagram username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/instagram/user/reels?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/post

One post or reel by URL: plays, likes, comments, caption, media URLs. Price: 1 credit. MCP tool: `instagram_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Instagram post or reel URL. |

```bash
curl "https://scrapeio.com/v1/instagram/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v2/instagram/post/comments

Comments on a post or reel. Price: 1 credit. MCP tool: `instagram_comments`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Instagram post or reel URL. |
| `sort` | string (recent, popular) | no | recent pages with likes; popular returns the top 15. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v2/instagram/post/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/post/comment/replies

Replies to one Instagram comment. Price: 1 credit. MCP tool: `instagram_comment_replies`.

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

```bash
curl "https://scrapeio.com/v1/instagram/post/comment/replies?url=...&comment_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v2/instagram/media/transcript

Transcript of a reel (videos under 2 minutes). Price: 2 credits. MCP tool: `instagram_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Instagram reel URL. |

```bash
curl "https://scrapeio.com/v2/instagram/media/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/search

Search Instagram accounts and hashtags. Price: 1 credit. MCP tool: `instagram_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |

```bash
curl "https://scrapeio.com/v1/instagram/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/search/posts

Search Instagram posts and reels by keyword. Price: 1 credit. MCP tool: `instagram_search_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/instagram/search/posts?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/hashtag

Recent posts under a hashtag. Price: 1 credit. MCP tool: `instagram_hashtag`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hashtag` | string | yes | Hashtag, with or without #. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/instagram/hashtag?hashtag=travel" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/user/similar

Accounts Instagram suggests as similar to a profile. Price: 1 credit. MCP tool: `instagram_similar_accounts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Instagram username, with or without @. |

```bash
curl "https://scrapeio.com/v1/instagram/user/similar?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v2/instagram/reels/search

Search Instagram reels by keyword, with plays, likes and comments. Price: 1 credit. MCP tool: `instagram_reels_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |
| `date_posted` | string (last-week, last-month, last-year) | no | Only reels from this window. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v2/instagram/reels/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/user/highlights

A profile's story highlights: id, title, cover. Price: 1 credit. MCP tool: `instagram_highlights`.

Send one of: `handle`, `user_id`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | no | Instagram username. |
| `user_id` | string | no | Instagram user id. Send this or handle. |

```bash
curl "https://scrapeio.com/v1/instagram/user/highlights?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/user/highlight/detail

The stories inside one highlight, with image and video links. Price: 1 credit. MCP tool: `instagram_highlight_detail`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Highlight id from the highlights endpoint. |

```bash
curl "https://scrapeio.com/v1/instagram/user/highlight/detail?id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/profile/post-count

How many posts a profile has. Price: 1 credit. MCP tool: `instagram_post_count`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Instagram username. |

```bash
curl "https://scrapeio.com/v1/instagram/profile/post-count?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/search/profiles

Search Instagram accounts by keyword. Price: 1 credit. MCP tool: `instagram_search_profiles`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |

```bash
curl "https://scrapeio.com/v1/instagram/search/profiles?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/user/tagged-posts

Posts other accounts tagged a profile in. Price: 1 credit. MCP tool: `instagram_tagged_posts`.

Send one of: `user_id`, `handle`.

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

```bash
curl "https://scrapeio.com/v1/instagram/user/tagged-posts?user_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/search/hashtag

Recent posts under an Instagram hashtag. Price: 1 credit. MCP tool: `instagram_search_hashtag`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hashtag` | string | yes | Hashtag, with or without #. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/instagram/search/hashtag?hashtag=travel" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/audio/reels

Get Reels By Audio Id Price: 1 credit. MCP tool: `instagram_audio_reels`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `audio_id` | string | yes | The audio id from the Instagram audio page URL. |
| `cursor` | string | no | Pagination cursor returned by Instagram from the previous response. |

```bash
curl "https://scrapeio.com/v1/instagram/audio/reels?audio_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/basic-profile

Basic Profile Price: 1 credit. MCP tool: `instagram_basic_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `userId` | string | no | Instagram user id |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/instagram/basic-profile" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/reels/trending

Trending Reels Price: 1 credit. MCP tool: `instagram_reels_trending`.

```bash
curl "https://scrapeio.com/v1/instagram/reels/trending" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/search/popular

Popular Search Price: 1 credit. MCP tool: `instagram_search_popular`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | The Popular topic to search for. |
| `cursor` | string | no | The opaque cursor returned by the previous response. |

```bash
curl "https://scrapeio.com/v1/instagram/search/popular?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/instagram/user/embed

Embed HTML Price: 1 credit. MCP tool: `instagram_user_embed`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Instagram handle |

```bash
curl "https://scrapeio.com/v1/instagram/user/embed?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## YouTube

### GET /v1/youtube/channel

YouTube channel: subscribers, total views, video count, description. Price: 1 credit. MCP tool: `youtube_channel`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Channel @handle, channel URL, or UC… channel id. |

```bash
curl "https://scrapeio.com/v1/youtube/channel?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/channel-videos

A channel's uploads (videos and Shorts), newest first, with views, likes and comments. Price: 1 credit. MCP tool: `youtube_channel_videos`.

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

```bash
curl "https://scrapeio.com/v1/youtube/channel-videos?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/video

One YouTube video or Short by URL: views, likes, comments, duration, tags. Price: 1 credit. MCP tool: `youtube_video`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | YouTube video or Short URL. |

```bash
curl "https://scrapeio.com/v1/youtube/video?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/video/comments

Comments on a YouTube video. Price: 1 credit. MCP tool: `youtube_comments`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | YouTube video URL. |
| `order` | string (relevance, time) | no | Ranking. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/youtube/video/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/search

Search YouTube videos with full stats. Price: 2 credits. MCP tool: `youtube_search`.

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

```bash
curl "https://scrapeio.com/v1/youtube/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/video/download

Direct MP4 stream URLs for a video (360p with audio, plus every format). Price: 2 credits. MCP tool: `youtube_download`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | YouTube video URL. |

```bash
curl "https://scrapeio.com/v1/youtube/video/download?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/video/transcript

A YouTube video's captions as text, with timestamps. Price: 1 credit. MCP tool: `youtube_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | YouTube video or Short URL. |
| `language` | string | no | Preferred language code, e.g. en. |

```bash
curl "https://scrapeio.com/v1/youtube/video/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/playlist

A playlist's details and its videos, with views and likes. Price: 1 credit. MCP tool: `youtube_playlist`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `playlist_id` | string | yes | Playlist id or playlist URL. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/youtube/playlist?playlist_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/channel/playlists

A channel's public playlists. Price: 1 credit. MCP tool: `youtube_channel_playlists`.

Send one of: `handle`, `channelId`.

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

```bash
curl "https://scrapeio.com/v1/youtube/channel/playlists?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/channel/shorts

A channel's Shorts, newest first, with views and likes. Price: 1 credit. MCP tool: `youtube_channel_shorts`.

Send one of: `handle`, `channelId`.

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

```bash
curl "https://scrapeio.com/v1/youtube/channel/shorts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/channel/lives

A channel's past and current live streams. Price: 1 credit. MCP tool: `youtube_channel_lives`.

Send one of: `handle`, `channelId`.

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

```bash
curl "https://scrapeio.com/v1/youtube/channel/lives?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/video/comment/replies

Replies to one YouTube comment. Price: 1 credit. MCP tool: `youtube_comment_replies`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `comment_id` | string | yes | Comment id from the comments endpoint. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/youtube/video/comment/replies?comment_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/search/typeahead

Search suggestions YouTube shows as you type. Price: 1 credit. MCP tool: `youtube_search_typeahead`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Partial search text. |

```bash
curl "https://scrapeio.com/v1/youtube/search/typeahead?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/channel/community-posts

A channel's community posts: text, images, polls, likes and comments. Price: 1 credit. MCP tool: `youtube_community_posts`.

Send one of: `handle`, `channelId`.

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

```bash
curl "https://scrapeio.com/v1/youtube/channel/community-posts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/community-post

One community post with its text, images and likes. Price: 1 credit. MCP tool: `youtube_community_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Community post URL. |

```bash
curl "https://scrapeio.com/v1/youtube/community-post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/channel/search

Search inside one channel's videos. Price: 1 credit. MCP tool: `youtube_channel_search`.

Send one of: `handle`, `channelId`.

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

```bash
curl "https://scrapeio.com/v1/youtube/channel/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/search/hashtag

Videos under a YouTube hashtag, with views and length. Price: 1 credit. MCP tool: `youtube_search_hashtag`.

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

```bash
curl "https://scrapeio.com/v1/youtube/search/hashtag?hashtag=travel" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/shorts/trending

Trending Shorts Price: 1 credit. MCP tool: `youtube_shorts_trending`.

```bash
curl "https://scrapeio.com/v1/youtube/shorts/trending" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/youtube/video/sponsors

Video Sponsors Price: 1 credit. MCP tool: `youtube_video_sponsors`.

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

```bash
curl "https://scrapeio.com/v1/youtube/video/sponsors?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## X (Twitter)

### GET /v1/twitter/profile

X profile: bio, avatar, followers, following, post count. Price: 1 credit. MCP tool: `twitter_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | X username, with or without @. |

```bash
curl "https://scrapeio.com/v1/twitter/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/user-tweets

A profile's posts, newest first, with views, likes, reposts, replies and bookmarks. Price: 1 credit. MCP tool: `twitter_user_tweets`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | X username, with or without @. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/twitter/user-tweets?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/tweet

One post by URL or id. Price: 1 credit. MCP tool: `twitter_tweet`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | X post URL. |

```bash
curl "https://scrapeio.com/v1/twitter/tweet?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/tweet/replies

Latest replies to a post. Price: 1 credit. MCP tool: `twitter_replies`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | X post URL. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/twitter/tweet/replies?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/search

Search X posts. X search operators work. Price: 1 credit. MCP tool: `twitter_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |
| `type` | string (top, latest) | no | Ranking. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/twitter/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/trends

Trending topics for a country. Price: 1 credit. MCP tool: `twitter_trends`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | no | Two-letter country code. |

```bash
curl "https://scrapeio.com/v1/twitter/trends" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/community

An X community: name, description, topic, member count and rules. Price: 1 credit. MCP tool: `twitter_community`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Community URL. |

```bash
curl "https://scrapeio.com/v1/twitter/community?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/community/tweets

Latest posts in an X community, with views and likes. Price: 1 credit. MCP tool: `twitter_community_tweets`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Community URL. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/twitter/community/tweets?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/search/posts

X's Top results for a keyword, with views and likes. Price: 1 credit. MCP tool: `twitter_search_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/twitter/search/posts?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitter/tweet/transcript

Transcript Price: 1 credit. MCP tool: `twitter_tweet_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Tweet URL |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/twitter/tweet/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Facebook

### GET /v1/facebook/profile

Facebook profile or Page: name, avatar, followers, category. Price: 1 credit. MCP tool: `facebook_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Facebook profile or Page URL, profile.php?id= URL, numeric id, or Page name. |

```bash
curl "https://scrapeio.com/v1/facebook/profile?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/profile/posts

Posts from a profile or Page with reactions, comments and shares. Price: 1 credit. MCP tool: `facebook_profile_posts`.

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

```bash
curl "https://scrapeio.com/v1/facebook/profile/posts?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/profile/reels

Videos and reels from a profile or Page with view counts. Price: 1 credit. MCP tool: `facebook_profile_videos`.

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

```bash
curl "https://scrapeio.com/v1/facebook/profile/reels?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/post

One Facebook post, video or reel by URL: views, reactions, comments, shares, video URL. Price: 1 credit. MCP tool: `facebook_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Facebook post, video or reel URL. |

```bash
curl "https://scrapeio.com/v1/facebook/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/post/comments

Top-level comments on a Facebook post or video. Price: 1 credit. MCP tool: `facebook_comments`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Facebook post or video URL. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/facebook/post/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/group

Facebook Group Info Price: 1 credit. MCP tool: `facebook_group`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | no | The Facebook group URL. |
| `group_id` | string | no | The numeric Facebook group ID. |

```bash
curl "https://scrapeio.com/v1/facebook/group" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/group/posts

Facebook Group Posts Price: 1 credit. MCP tool: `facebook_group_posts`.

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

```bash
curl "https://scrapeio.com/v1/facebook/group/posts" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/post/comment/replies

Comment Replies Price: 1 credit. MCP tool: `facebook_post_comment_replies`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `feedback_id` | string | yes | The feedbackid of the comment. |
| `expansion_token` | string | yes | The expansiontoken of the comment. |
| `cursor` | string | no | The cursor to paginate to the next page |

```bash
curl "https://scrapeio.com/v1/facebook/post/comment/replies?feedback_id=...&expansion_token=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/post/transcript

Transcript Price: 1 credit. MCP tool: `facebook_post_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Facebook post URL |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/facebook/post/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/profile/events

Profile Events Price: 1 credit. MCP tool: `facebook_profile_events`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the public Facebook page |
| `cursor` | string | no | The cursor to paginate to get more events |

```bash
curl "https://scrapeio.com/v1/facebook/profile/events?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/profile/photos

Profile Photos Price: 1 credit. MCP tool: `facebook_profile_photos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Facebook page URL |
| `next_page_id` | string | no | To paginate through to the next page |
| `cursor` | string | no | To paginate through to the next page |

```bash
curl "https://scrapeio.com/v1/facebook/profile/photos?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/search/videos

Search Videos Price: 1 credit. MCP tool: `facebook_search_videos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | The keyword or phrase to search for |
| `cursor` | string | no | The opaque cursor returned by the previous response. |

```bash
curl "https://scrapeio.com/v1/facebook/search/videos?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Cosmos

### GET /v1/cosmos/cluster

Collection Price: 1 credit. MCP tool: `cosmos_cluster`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Public Cosmos collection URL. |

```bash
curl "https://scrapeio.com/v1/cosmos/cluster?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/cosmos/cluster/posts

Collection Posts Price: 1 credit. MCP tool: `cosmos_cluster_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Public Cosmos collection URL. |
| `cursor` | string | no | Pass the previous response cursor unchanged. |

```bash
curl "https://scrapeio.com/v1/cosmos/cluster/posts?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/cosmos/post

Post Price: 1 credit. MCP tool: `cosmos_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Public Cosmos post URL. |

```bash
curl "https://scrapeio.com/v1/cosmos/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/cosmos/profile

Profile Price: 1 credit. MCP tool: `cosmos_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Cosmos username without a profile URL. |

```bash
curl "https://scrapeio.com/v1/cosmos/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/cosmos/search

Search Price: 1 credit. MCP tool: `cosmos_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search text. |
| `cursor` | string | no | Pass the previous response cursor unchanged. |

```bash
curl "https://scrapeio.com/v1/cosmos/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/cosmos/user/clusters

User Collections Price: 1 credit. MCP tool: `cosmos_user_clusters`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Cosmos username without a profile URL. |
| `cursor` | string | no | Pass the previous response cursor unchanged. |

```bash
curl "https://scrapeio.com/v1/cosmos/user/clusters?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/cosmos/user/posts

User Posts Price: 1 credit. MCP tool: `cosmos_user_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Cosmos username without a profile URL. |
| `cursor` | string | no | Pass the previous response cursor unchanged. |

```bash
curl "https://scrapeio.com/v1/cosmos/user/posts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Reddit

### GET /v1/reddit/post

Post Price: 1 credit. MCP tool: `reddit_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Reddit post URL |

```bash
curl "https://scrapeio.com/v1/reddit/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/reddit/post/comments

Post Comments Price: 1 credit. MCP tool: `reddit_post_comments`.

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

```bash
curl "https://scrapeio.com/v1/reddit/post/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/reddit/post/transcript

Post Transcript Price: 1 credit. MCP tool: `reddit_post_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Reddit post URL or direct v.redd.it video URL |
| `language` | string | no | 2 letter language code. |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/reddit/post/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/reddit/search

Search Price: 1 credit. MCP tool: `reddit_search`.

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

```bash
curl "https://scrapeio.com/v1/reddit/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/reddit/subreddit

Subreddit Posts Price: 1 credit. MCP tool: `reddit_subreddit`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `subreddit` | string | yes | Subreddit name |
| `timeframe` | string (all, day, week, month, year) | no | Timeframe to get posts from |
| `sort` | string (best, hot, new, top, rising) | no | Sort order |
| `trim` | boolean | no | Set to true for a trimmed down version of the response |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 | no | After to get more posts. |

```bash
curl "https://scrapeio.com/v1/reddit/subreddit?subreddit=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/reddit/subreddit/details

Subreddit Details Price: 1 credit. MCP tool: `reddit_subreddit_details`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `subreddit` | string | no | Subreddit name. |
| `url` | string | no | Subreddit URL |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/reddit/subreddit/details" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/reddit/subreddit/search

Subreddit Search Price: 1 credit. MCP tool: `reddit_subreddit_search`.

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

```bash
curl "https://scrapeio.com/v1/reddit/subreddit/search?subreddit=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Spotify

### GET /v1/spotify/album

Album Price: 1 credit. MCP tool: `spotify_album`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Spotify album id. |
| `url` | string | no | Spotify album URL. |

```bash
curl "https://scrapeio.com/v1/spotify/album" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/spotify/artist

Artist Price: 1 credit. MCP tool: `spotify_artist`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Spotify artist id. |
| `url` | string | no | Spotify artist URL. |

```bash
curl "https://scrapeio.com/v1/spotify/artist" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/spotify/playlist

Playlist Price: 1 credit. MCP tool: `spotify_playlist`.

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

```bash
curl "https://scrapeio.com/v1/spotify/playlist" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/spotify/podcast

Podcast Price: 1 credit. MCP tool: `spotify_podcast`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Spotify podcast id. |
| `url` | string | no | Spotify podcast URL. |

```bash
curl "https://scrapeio.com/v1/spotify/podcast" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/spotify/podcast/episodes

Podcast Episodes Price: 1 credit. MCP tool: `spotify_podcast_episodes`.

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

```bash
curl "https://scrapeio.com/v1/spotify/podcast/episodes" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/spotify/search

Search Price: 1 credit. MCP tool: `spotify_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search query |

```bash
curl "https://scrapeio.com/v1/spotify/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/spotify/track

Track Price: 1 credit. MCP tool: `spotify_track`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Spotify track id. |
| `url` | string | no | Spotify song URL. |

```bash
curl "https://scrapeio.com/v1/spotify/track" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## LinkedIn

### GET /v1/linkedin/company

Company Page Price: 1 credit. MCP tool: `linkedin_company`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the LinkedIn company page to get |

```bash
curl "https://scrapeio.com/v1/linkedin/company?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkedin/company/posts

Company Posts Price: 1 credit. MCP tool: `linkedin_company_posts`.

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

```bash
curl "https://scrapeio.com/v1/linkedin/company/posts?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkedin/post

Post Price: 1 credit. MCP tool: `linkedin_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the LinkedIn post to get |

```bash
curl "https://scrapeio.com/v1/linkedin/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkedin/post/transcript

Post Transcript Price: 1 credit. MCP tool: `linkedin_post_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the LinkedIn post to get the transcript from |

```bash
curl "https://scrapeio.com/v1/linkedin/post/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkedin/profile

Person's Profile Price: 1 credit. MCP tool: `linkedin_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the LinkedIn profile to get |

```bash
curl "https://scrapeio.com/v1/linkedin/profile?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkedin/search/posts

Search Posts Price: 1 credit. MCP tool: `linkedin_search_posts`.

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

```bash
curl "https://scrapeio.com/v1/linkedin/search/posts?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Facebook Ad Library

### GET /v1/facebook/adLibrary/ad

Ad Details Price: 1 credit. MCP tool: `facebook_adlibrary_ad`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Facebook Ad Id |
| `url` | string | no | Facebook Ad URL |
| `get_transcript` | boolean | no | Transcription is opt-in via gettranscript=true. |
| `trim` | boolean | no | Set to true for a trimmed down version of the response |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/facebook/adLibrary/ad" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/adLibrary/ad/transcript

Ad Transcript Price: 1 credit. MCP tool: `facebook_adlibrary_ad_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Facebook Ad Id |
| `url` | string | no | Facebook Ad URL |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/facebook/adLibrary/ad/transcript" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/adLibrary/company/ads

Company Ads Price: 1 credit. MCP tool: `facebook_adlibrary_company_ads`.

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

```bash
curl "https://scrapeio.com/v1/facebook/adLibrary/company/ads" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/adLibrary/search/ads

Search Price: 1 credit. MCP tool: `facebook_adlibrary_search_ads`.

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

```bash
curl "https://scrapeio.com/v1/facebook/adLibrary/search/ads?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/adLibrary/search/companies

Search for Companies Price: 1 credit. MCP tool: `facebook_adlibrary_search_companies`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Keyword to search for |

```bash
curl "https://scrapeio.com/v1/facebook/adLibrary/search/companies?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Link in bio

### GET /v1/linktree

A Linktree page: name, bio, avatar, every link and social icon. Price: 1 credit. MCP tool: `linktree`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Linktree URL or username. |

```bash
curl "https://scrapeio.com/v1/linktree?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/komi

Komi page Price: 1 credit. MCP tool: `komi`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | URL to Komi page |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/komi?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkbio

Linkbio page Price: 1 credit. MCP tool: `linkbio`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | URL to Linkbio (lnk.bio) page |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/linkbio?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkme

Profile Price: 1 credit. MCP tool: `linkme`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Linkme profile URL |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/linkme?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/pillar

Pillar page Price: 1 credit. MCP tool: `pillar`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | URL to Pillar page |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/pillar?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Pinterest

### GET /v1/pinterest/board

A board's details and its latest pins, with saves. Price: 1 credit. MCP tool: `pinterest_board`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Board URL. |

```bash
curl "https://scrapeio.com/v1/pinterest/board?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/pinterest/pin

One pin: image, description, outbound link, saves, board and author. Price: 1 credit. MCP tool: `pinterest_pin`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Pin URL. |

```bash
curl "https://scrapeio.com/v1/pinterest/pin?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/pinterest/search

Search Price: 1 credit. MCP tool: `pinterest_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search query |
| `trim` | boolean | no | Set to true for a trimmed down version of the response |
| `cursor` | string | no | Cursor |

```bash
curl "https://scrapeio.com/v1/pinterest/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/pinterest/topic

Topic Price: 1 credit. MCP tool: `pinterest_topic`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The Pinterest ideas URL of the topic to get. |

```bash
curl "https://scrapeio.com/v1/pinterest/topic?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/pinterest/user/boards

User Boards Price: 1 credit. MCP tool: `pinterest_user_boards`.

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

```bash
curl "https://scrapeio.com/v1/pinterest/user/boards?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Rumble

### GET /v1/rumble/channel/videos

Channel Videos Price: 1 credit. MCP tool: `rumble_channel_videos`.

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

```bash
curl "https://scrapeio.com/v1/rumble/channel/videos" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/rumble/search

Search Price: 1 credit. MCP tool: `rumble_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search query. |
| `cursor` | string | no | Cursor from the previous response. |

```bash
curl "https://scrapeio.com/v1/rumble/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/rumble/video

Video Price: 1 credit. MCP tool: `rumble_video`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Rumble video URL. |

```bash
curl "https://scrapeio.com/v1/rumble/video?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/rumble/video/comments

Comments Price: 1 credit. MCP tool: `rumble_video_comments`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Rumble video URL. |

```bash
curl "https://scrapeio.com/v1/rumble/video/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/rumble/video/transcript

Transcript Price: 1 credit. MCP tool: `rumble_video_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Rumble video URL. |

```bash
curl "https://scrapeio.com/v1/rumble/video/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Threads

### GET /v1/threads/post

Post Price: 1 credit. MCP tool: `threads_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the post to get |
| `trim` | boolean | no | Set to true for a trimmed down version of the response |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/threads/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/threads/profile

Profile Price: 1 credit. MCP tool: `threads_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Threads username |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/threads/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/threads/search

Search by Keyword Price: 1 credit. MCP tool: `threads_search`.

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

```bash
curl "https://scrapeio.com/v1/threads/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/threads/search/users

Search Users Price: 1 credit. MCP tool: `threads_search_users`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Username to search for |

```bash
curl "https://scrapeio.com/v1/threads/search/users?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/threads/user/posts

Posts Price: 1 credit. MCP tool: `threads_user_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Threads username |
| `trim` | boolean | no | Set to true for a trimmed down version of the response |

```bash
curl "https://scrapeio.com/v1/threads/user/posts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## TikTok Shop

### GET /v1/tiktok/product

Product Details Price: 1 credit. MCP tool: `tiktok_product`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the product to get details for. |
| `region` | string | no | Region for the product details request. |

```bash
curl "https://scrapeio.com/v1/tiktok/product?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/shop/product/reviews

Product Reviews Price: 1 credit. MCP tool: `tiktok_shop_product_reviews`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/shop/product/reviews" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/shop/products

Shop Products Price: 1 credit. MCP tool: `tiktok_shop_products`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/shop/products?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/shop/search

Shop Search Price: 1 credit. MCP tool: `tiktok_shop_search`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/shop/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/user/showcase

User Showcase Price: 1 credit. MCP tool: `tiktok_user_showcase`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | The handle of the user |
| `region` | string | no | Region to put the proxy in. |
| `cursor` | string | no | The cursor to the next page of products |

```bash
curl "https://scrapeio.com/v1/tiktok/user/showcase?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Twitch

### GET /v1/twitch/clip

Clip Price: 1 credit. MCP tool: `twitch_clip`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Twitch clip URL |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/twitch/clip?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitch/clip/transcript

Clip Transcript Price: 1 credit. MCP tool: `twitch_clip_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Twitch clip URL |
| `use_ai_as_fallback` | boolean | no | Use paid AI only when native captions are unavailable. |

```bash
curl "https://scrapeio.com/v1/twitch/clip/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitch/profile

Profile Price: 1 credit. MCP tool: `twitch_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Twitch handle |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/twitch/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitch/user/schedule

User Schedule Price: 1 credit. MCP tool: `twitch_user_schedule`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Twitch handle |

```bash
curl "https://scrapeio.com/v1/twitch/user/schedule?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/twitch/user/videos

User Videos Price: 1 credit. MCP tool: `twitch_user_videos`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Twitch handle |
| `filter_by` | string (HIGHLIGHT, ARCHIVE, UPLOAD) | no | Filter by |
| `sort_by` | string (TIME, VIEWS) | no | Sort by |

```bash
curl "https://scrapeio.com/v1/twitch/user/videos?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Apple Music

### GET /v1/apple-music/album

Album Price: 1 credit. MCP tool: `apple_music_album`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Apple Music album id. |
| `url` | string | no | Apple Music album URL. |

```bash
curl "https://scrapeio.com/v1/apple-music/album" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/apple-music/artist

Artist Price: 1 credit. MCP tool: `apple_music_artist`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Apple Music artist id. |
| `url` | string | no | Apple Music artist URL. |

```bash
curl "https://scrapeio.com/v1/apple-music/artist" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/apple-music/search

Search Price: 1 credit. MCP tool: `apple_music_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Search query |
| `type` | string | no | Result type to return. |

```bash
curl "https://scrapeio.com/v1/apple-music/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/apple-music/track

Track Price: 1 credit. MCP tool: `apple_music_track`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Apple Music song id. |
| `url` | string | no | Apple Music song URL or album track URL. |

```bash
curl "https://scrapeio.com/v1/apple-music/track" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Bluesky

### GET /v1/bluesky/profile

Bluesky profile: bio, avatar, followers, following, post count. Price: 1 credit. MCP tool: `bluesky_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Bluesky handle, e.g. bsky.app. |

```bash
curl "https://scrapeio.com/v1/bluesky/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/bluesky/user/posts

A profile's posts, newest first, with likes, replies and reposts. Price: 1 credit. MCP tool: `bluesky_user_posts`.

Send one of: `handle`, `user_id`.

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

```bash
curl "https://scrapeio.com/v1/bluesky/user/posts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/bluesky/post

One Bluesky post with its stats and direct replies. Price: 1 credit. MCP tool: `bluesky_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Bluesky post URL. |

```bash
curl "https://scrapeio.com/v1/bluesky/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Creator Tools

### GET /v1/detect-age-gender

Get Age and Gender Price: 1 credit. MCP tool: `detect_age_gender`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | URL to users social profile |

```bash
curl "https://scrapeio.com/v1/detect-age-gender?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/find-creator-emails

Find Creator Emails Price: up to 10 credits. MCP tool: `find_creator_emails`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `platform` | string (instagram, tiktok, youtube, x, twitter, facebook) | yes | Source social platform |
| `handle` | string | yes | Creator handle without a profile URL. |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/find-creator-emails?platform=...&handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/find-social-profiles

Find Social Profiles Price: up to 10 credits. MCP tool: `find_social_profiles`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `platform` | string (instagram, tiktok, youtube, x, twitter, facebook) | yes | Source social platform |
| `handle` | string | yes | Creator handle without a profile URL. |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/find-social-profiles?platform=...&handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Facebook Events

### GET /v1/facebook/event/details

Event Details Price: 1 credit. MCP tool: `facebook_event_details`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | The ID of the event |
| `url` | string | no | The URL of the event |

```bash
curl "https://scrapeio.com/v1/facebook/event/details" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/events

Events Price: 1 credit. MCP tool: `facebook_events`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The URL of the city's Facebook Events page |
| `time` | string (today, this_week, next_week) | no | The time frame to search for. |
| `cursor` | string | no | The cursor to paginate to the next page |

```bash
curl "https://scrapeio.com/v1/facebook/events?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/events/search

Search Events Price: 1 credit. MCP tool: `facebook_events_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | The query to search for |
| `cursor` | string | no | The cursor to paginate to the next page |

```bash
curl "https://scrapeio.com/v1/facebook/events/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Facebook Marketplace

### GET /v1/facebook/marketplace/item

Marketplace Item Price: 1 credit. MCP tool: `facebook_marketplace_item`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | Facebook Marketplace item id |
| `url` | string | no | Facebook Marketplace item URL |

```bash
curl "https://scrapeio.com/v1/facebook/marketplace/item" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/marketplace/location/search

Marketplace Location Search Price: 1 credit. MCP tool: `facebook_marketplace_location_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Location search query |

```bash
curl "https://scrapeio.com/v1/facebook/marketplace/location/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/facebook/marketplace/search

Marketplace Search Price: 1 credit. MCP tool: `facebook_marketplace_search`.

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

```bash
curl "https://scrapeio.com/v1/facebook/marketplace/search?lat=...&lng=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## GitHub

### GET /v1/github/user/contributions

A user's contribution calendar: count per day and the yearly total. Price: 1 credit. MCP tool: `github_user_contributions`.

Send one of: `handle`, `url`.

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

```bash
curl "https://scrapeio.com/v1/github/user/contributions?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/github/trending/repositories

GitHub's trending repositories, with stars gained in the period. Price: 1 credit. MCP tool: `github_trending_repositories`.

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

```bash
curl "https://scrapeio.com/v1/github/trending/repositories" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/github/trending/developers

GitHub's trending developers and their most popular repo. Price: 1 credit. MCP tool: `github_trending_developers`.

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

```bash
curl "https://scrapeio.com/v1/github/trending/developers" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Google Ad Library

### GET /v1/google/ad

Ad Details Price: 1 credit. MCP tool: `google_ad`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The url of the ad |
| `cache_max_age` | string (1d, 3d, 7d, 14d, 30d) | no | 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 |

```bash
curl "https://scrapeio.com/v1/google/ad?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/google/adLibrary/advertisers/search

Advertiser Search Price: 1 credit. MCP tool: `google_adlibrary_advertisers_search`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | The query to search for |
| `region` | string | no | 2-letter country code to search in. |

```bash
curl "https://scrapeio.com/v1/google/adLibrary/advertisers/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/google/company/ads

Company Ads Price: up to 25 credits. MCP tool: `google_company_ads`.

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

```bash
curl "https://scrapeio.com/v1/google/company/ads" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Kwai

### GET /v1/kwai/post

Post Price: 1 credit. MCP tool: `kwai_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | no | Kwai post URL |

```bash
curl "https://scrapeio.com/v1/kwai/post" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/kwai/profile

Profile Price: 1 credit. MCP tool: `kwai_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | no | Kwai profile handle. |
| `url` | string | no | Kwai profile URL. |

```bash
curl "https://scrapeio.com/v1/kwai/profile" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/kwai/user/posts

User Posts Price: 1 credit. MCP tool: `kwai_user_posts`.

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

```bash
curl "https://scrapeio.com/v1/kwai/user/posts" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Snapchat

### GET /v1/snapchat/profile

A Snapchat public profile: name, bio, subscribers, category. Price: 1 credit. MCP tool: `snapchat_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Snapchat username. |

```bash
curl "https://scrapeio.com/v1/snapchat/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/snapchat/spotlight

Spotlight by Link Price: 1 credit. MCP tool: `snapchat_spotlight`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Snapchat Spotlight URL. |

```bash
curl "https://scrapeio.com/v1/snapchat/spotlight?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/snapchat/spotlight/comments

Spotlight Comments by Link Price: 1 credit. MCP tool: `snapchat_spotlight_comments`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Snapchat Spotlight URL. |
| `cursor` | string | no | Pagination cursor from the previous response. |

```bash
curl "https://scrapeio.com/v1/snapchat/spotlight/comments?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## SoundCloud

### GET /v1/soundcloud/artist

Artist Price: 1 credit. MCP tool: `soundcloud_artist`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | no | SoundCloud artist handle. |
| `url` | string | no | SoundCloud artist URL. |

```bash
curl "https://scrapeio.com/v1/soundcloud/artist" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/soundcloud/artist/tracks

Artist Tracks Price: 1 credit. MCP tool: `soundcloud_artist_tracks`.

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

```bash
curl "https://scrapeio.com/v1/soundcloud/artist/tracks" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/soundcloud/track

Track Price: 1 credit. MCP tool: `soundcloud_track`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | SoundCloud track URL. |

```bash
curl "https://scrapeio.com/v1/soundcloud/track?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Telegram

### GET /v1/telegram/channel

A public channel: name, description, subscribers, media counts. Price: 1 credit. MCP tool: `telegram_channel`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Channel handle, @handle or t.me URL. |

```bash
curl "https://scrapeio.com/v1/telegram/channel?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/telegram/channel/posts

A public channel's latest posts with views, newest first. Price: 1 credit. MCP tool: `telegram_channel_posts`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Channel handle, @handle or t.me URL. |
| `cursor` | string | no | Cursor from the previous page's data.cursor. |

```bash
curl "https://scrapeio.com/v1/telegram/channel/posts?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/telegram/post

One public channel post with its text, media and views. Price: 1 credit. MCP tool: `telegram_post`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Post URL, e.g. https://t.me/durov/123. |

```bash
curl "https://scrapeio.com/v1/telegram/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Truth Social

### GET /v1/truthsocial/post

Post Price: 1 credit. MCP tool: `truthsocial_post`.

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

```bash
curl "https://scrapeio.com/v1/truthsocial/post?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/truthsocial/profile

Profile Price: 1 credit. MCP tool: `truthsocial_profile`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | yes | Truth Social username |

```bash
curl "https://scrapeio.com/v1/truthsocial/profile?handle=nike" -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/truthsocial/user/posts

User Posts Price: 1 credit. MCP tool: `truthsocial_user_posts`.

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

```bash
curl "https://scrapeio.com/v1/truthsocial/user/posts" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Kick

### GET /v1/kick/clip

Clip Price: 1 credit. MCP tool: `kick_clip`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Kick clip URL |

```bash
curl "https://scrapeio.com/v1/kick/clip?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/kick/clip/transcript

Clip Transcript Price: 1 credit. MCP tool: `kick_clip_transcript`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | Kick clip URL |
| `use_ai_as_fallback` | boolean | no | Use paid AI only when native captions are unavailable. |

```bash
curl "https://scrapeio.com/v1/kick/clip/transcript?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## LinkedIn Ad Library

### GET /v1/linkedin/ad

Ad Details Price: 1 credit. MCP tool: `linkedin_ad`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | yes | The url of the ad |

```bash
curl "https://scrapeio.com/v1/linkedin/ad?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/linkedin/ads/search

Search Ads Price: 1 credit. MCP tool: `linkedin_ads_search`.

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

```bash
curl "https://scrapeio.com/v1/linkedin/ads/search" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## TikTok Ad Library

### GET /v1/tiktok/ad-library/ad

Ad Library Ad Price: 1 credit. MCP tool: `tiktok_ad_library_ad`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/ad-library/ad?ad_id=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

### GET /v1/tiktok/ad-library/search

Ad Library Search Price: 1 credit. MCP tool: `tiktok_ad_library_search`.

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

```bash
curl "https://scrapeio.com/v1/tiktok/ad-library/search" -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Amazon Shop

### GET /v1/amazon/shop

Amazon Shop page Price: 1 credit. MCP tool: `amazon_shop`.

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

```bash
curl "https://scrapeio.com/v1/amazon/shop?url=..." -H "x-api-key: $SCRAPEIO_API_KEY"
```

## Google Search

### GET /v1/google/search

Search Price: 1 credit. MCP tool: `google_search`.

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

```bash
curl "https://scrapeio.com/v1/google/search?query=coffee" -H "x-api-key: $SCRAPEIO_API_KEY"
```