ScrapeCreators MCP Server & CLI

ScrapeCreators MCP server and CLI for Codex and AI agents. 190 tools: five local/account reads and 185 potentially paid calls for public social profiles, posts, transcripts, comments, ads and bounded research.

One package provides local MCP, the same operations as task CLI commands, and a bundled desktop .mcpb extension.

Built and maintained by Navid Moazzez. Built on Slipway, which turns one definition of each tool into the MCP server and the CLI. Complete installation and private account setup are in INSTALL.md.

The terminal illustrates shipped public research tools with sample data. It is a presentation preview, not a verified live-account request.

You need a private ScrapeCreators API key and sufficient provider access/credits. This community product is maintained by Navid Media and preserves AGPL-3.0-or-later. ScrapeCreators already has an official CLI and hosted MCP; useful differences and limitations are compared below.

Two ways to use it

Command line

npm install -g @thenavidm/scrapecreators-mcp-cli@latest
scrapecreators-cli
scrapecreators-cli instagram-profile --help
scrapecreators-cli schema research-batch
scrapecreators-cli scrapecreators-get-credit-balance --agent

Configure private access before account calls. Potentially paid research requires --confirm; --yes and --agent do not authorize it.

MCP server, for your AI app

codex mcp add scrapecreators -- npx -y @thenavidm/scrapecreators-mcp-cli@latest

Then ask: Check credit balance, then show the exact public-profile lookup before I approve the paid call. Full client/OS setup is in INSTALL.md.

Which one

| Where you work | Surface | | --- | --- | | Codex or another shell agent | Local MCP, shared CLI or both | | Desktop chat | Compatible local MCP/.mcpb host | | Scripts/CI | Shared task CLI or MCP client | | Remote-URL-only client | Official provider hosted MCP |

Features

| Capability | CLI | MCP | | --- | --- | --- | | Public profiles | instagram-profile / tiktok-profile | instagram_profile / tiktok_profile | | Video transcripts | youtube-transcript | youtube_transcript | | Public ads | facebook-ad-library-search-post | facebook_ad_library_search_post | | Account credit/history | scrapecreators-get-credit-balance | scrapecreators_get_credit_balance | | Exact bounded research | research-batch | research_batch | | Private account labels | list-accounts / --account | list_accounts / account | | Setup diagnosis | doctor / login | CLI utilities |

Contents

| Number | Section | Covers | | --- | --- | --- | | 1 | What you can ask it | Practical research | | 2 | Quick install | Both binaries and desktop | | 3 | Set up ScrapeCreators access | Keys, credits and caching | | 4 | Connect your client | Clients and OS | | 5 | Check it works | Doctor and first account read | | 6 | Output, flags and exit codes | Schema-derived flags and scripting | | 7 | MCP or CLI and token cost | Measured evidence requirements | | 8 | Every tool and argument | All current tools and arguments | | 9 | Creator, transcript and ad research workflows | Profiles, transcripts, ads and batch | | 10 | Pagination, credits and request budgets | Opaque cursors and actual charges | | 11 | Several private accounts | Named credentials | | 12 | Approving paid research safely | Per-call approval and policies | | 13 | How it works | Shared handlers and schema sync | | 14 | Your data | Direct API and privacy | | 15 | Environment variables | Private credentials and tuning | | 16 | Updates and removal | Upgrade and revoke | | 17 | Troubleshooting | Errors and remedies | | 18 | API coverage and comparisons | Official and community choices | | 19 | Versions | Release and migration history | | 20 | FAQ | Accordion answers |

1. What you can ask it

• Inspect a selected public creator profile and one page of recent posts.
• Retrieve the specific YouTube transcript I approved, preserving track language.
• Research matching public ads in the chosen country and status.
• Compare a bounded set of public profiles in one named private account.
• Check credit balance and account request history before repeating a failed lookup.

The current schema supplies 188 API operations across 37 groups. list_accounts is local; research_batch is a shared local workflow. Actual discovery gives 190 tools: five local/account reads and 185 potentially paid calls. Account metadata remains available in read-only mode; paid research requires explicit confirmation, even for GET.

ScrapeCreators already offers official MCP, CLI and research skills. This owned wrapper adds enforced paid-call approval, named private credentials and bounded prevalidated batches. Fixture/protocol validation is separate from live account outcomes, GUI installation and measured token evidence.

2. Quick install

npm install -g @thenavidm/scrapecreators-mcp-cli@latest
scrapecreators-cli --version
scrapecreators-cli login
scrapecreators-cli doctor
scrapecreators-cli tools

Node 22+ is required for manual CLI/MCP setup. Discovery, schemas and list_accounts work without a key. The scrapecreators-3.0.0.mcpb desktop archive bundles production dependencies for a compatible host. Full setup is in INSTALL.md.

After private environment configuration:

codex mcp add scrapecreators -- npx -y @thenavidm/scrapecreators-mcp-cli@latest
codex mcp list

3. Set up ScrapeCreators access

Private API key

1. Sign in to the intended account at app.scrapecreators.com and open its API Keys area.
2. Retrieve or create the key for the intended account/team. API access uses your ScrapeCreators key, not social-platform passwords, cookies or a GitHub CLI token.
3. Save the key in a private token-only file outside repositories, then set SCRAPECREATORS_TOKEN_FILE to its absolute path. SCRAPECREATORS_API_KEY in private local client/shell settings is the alternative.
4. Run scrapecreators-cli doctor, then scrapecreators-cli doctor --network. Network doctor reads current account credit metadata and prints no account details.
5. Check the required endpoint, available balance and approved task before any potentially paid research call.

Requests use x-api-key, with the fixed origin https://api.scrapecreators.com. Routes retain their current v1/v2/v3 prefixes. There is no invented dated-version header. login prints instructions; it does not sign up, save credentials or complete OAuth. The official hosted MCP supports its own OAuth/API-key flow, and the official CLI provides interactive key setup and GitHub device signup. Those are separate products, not hidden features of this wrapper.

On macOS/Linux, use an owner-only key file (0600) in a private directory (0700). On Windows, restrict its ACL to your user. Files must be regular, not symlinks, and no larger than 64 KB. A file overrides the environment key and is cached until restart. GUI client settings and terminal environments are separate. Never place actual credentials in chat, command arguments, project config, issues or examples. This package does not automatically load .env files or use an OS keychain.

Access, pricing and quotas

A ScrapeCreators account with API access and enough credits is required; installing this free AGPL wrapper does not purchase data. The provider pricing page, checked October 2, 2026, lists 100 starting credits, $47 for 25,000 credits and $497 for 500,000 credits, with no mandatory subscription and nonexpiring purchased credits. Bonus/device-signup allowances have different conditions; check your actual dashboard. No universal social-platform admin role or OAuth scope list is imposed by this API-key wrapper.

Most live research requests cost one credit, but current endpoint exceptions include TikTok audience demographics (26) and Find Social Profiles (10). A supported cache hit costs zero; a miss can use the normal endpoint charge. Do not treat max_calls as a credit or money limit. Check response credits_charged, cached and cached_at where supplied, and the account request history. Provider pricing can change.

The provider advertises no account-level rate/concurrency cap. Local pacing defaults to 150 ms between calls per account/process as a reliability choice, not a provider quota rule or reservation. Sequential batches cap at 20 explicit calls. Research GET and POST requests never retry automatically; a lost response can still have consumed credits. Only account-metadata GET 429 responses can retry, at most two by default, for Retry-After waits of ten seconds or less. Longer waits return exit 7. No failed-call billing guarantee is invented.

Provider caching and public-data limits

Only endpoints whose schema includes cache_max_age accept that option here: 1d, 3d, 7d, 14d or 30d. A cache hit is older data, so retain its timestamp. Team owners can disable provider caching on the API Keys page; then the option does not guarantee a hit or zero credits. See the cache documentation.

This is public-data research, not social-platform publishing or a bypass for private profiles. Availability, geographic results, transcript tracks, cursor validity and upstream platform changes affect results. Account metadata/history can reveal private usage. Choose only the requested public resources and keep returned personal or business data out of public logs.

4. Connect your client

INSTALL.md retains the established client setup for Codex, Claude Code, Claude Desktop extension/manual config, Cursor, VS Code/Copilot, Windsurf, Zed, Gemini CLI, Cline, Docker and other stdio clients on macOS, Windows and Linux. Codex is the current priority; Claude Code is optional.

Use command npx with arguments -y, @thenavidm/scrapecreators-mcp-cli@latest, and private local credential settings. Remote-only clients can use the provider's official https://api.scrapecreators.com/mcp endpoint with its supported OAuth/API-key connection. This local package has no public HTTP relay.

The shipped SKILL.md guides a shell agent. Make it available through the client's supported skills location; npm installation alone does not register it. Client approval and confirm=true are separate: the guard requires approval for this specific paid action, not permission inferred from returned content.

5. Check it works

scrapecreators-cli --version
scrapecreators-cli doctor
scrapecreators-cli doctor --network
scrapecreators-cli list-accounts --agent
scrapecreators-cli scrapecreators-get-credit-balance --agent

Network doctor performs GET /v1/account/credit-balance and reports authentication without account content. A successful account read proves that request, not every public-data endpoint. Full discovery exposes 190 tools, read-only exposes five. Missing configuration exits 10; invalid arguments and refused paid research exit 2.

For an approved first research request, use a public handle you selected and an acceptable cache age:

scrapecreators-cli instagram-profile --handle PUBLIC_HANDLE --cache-max-age 7d --confirm --agent

6. Output, flags and exit codes

Tool names become dashed commands; underscores are accepted too. Path parameter names follow the discovered schema, such as continuationToken → --continuation-token. Body tools accept individual top-level flags, complete --payload JSON, or --payload-file pointing to a regular JSON body file up to 5 MB. Do not mix those body routes. Path/query flags remain separate. Nested objects take JSON and array flags repeat once per item; a whole array is not a single item.

scrapecreators-cli instagram-profile --help
scrapecreators-cli schema reddit-post-comments-post
scrapecreators-cli youtube-comments --url "https://www.youtube.com/watch?v=VIDEO_ID" --continuation-token OPAQUE_TOKEN --confirm --agent

IDs/cursors above are illustrative; use the selected public resource and cursor from its prior response. Nullable fields require an actual JSON null inside payload; --field null is a string. Nested values preserve current upstream constraints; unknown top-level body fields are refused. Body-required fields are validated during execution even when the wrapper schema allows an alternative payload route. Operations whose upstream request body is required need body flags or an explicit payload; a deliberately supplied empty object is sent as JSON, never omitted.

| Flag | Behavior | | --- | --- | | --help / schema COMMAND | Current argument help / full JSON Schema | | --json | Structured JSON | | --compact | One-line JSON | | --agent | Compact JSON and no prompts; never confirms a write | | --select a,b.c | Keep selected fields, including nested objects/arrays | | --no-color / --no-input | Noninteractive switches | | --yes | Never replaces paid-call confirmation | | --confirm | Approve only the requested paid research | | --account NAME | Select private local credentials | | --payload JSON / --payload-file PATH | Complete request body, mutually exclusive with body flags |

| Exit | Meaning | | --- | --- | | 0 | Success | | 1 | Unexpected error | | 2 | Invalid arguments or refused paid call, an unknown command or a hidden write | | 3 | Resource not found | | 4 | Authentication/permission failure | | 5 | API/transport failure | | 7 | Rate limit | | 10 | Missing or invalid private configuration |

Results go to stdout, errors as JSON to stderr. Selection changes local output, not the original API response or provider charge. API success is not proof that public data is current, exhaustive or complete.

7. MCP or CLI and token cost

MCP and CLI use the same schemas, validation and HTTP handlers: Slipway builds the MCP server, over stdio or --http, and the CLI from each tool's one definition; there is no second API implementation.

Measured on 2026-10-05 against 2.0.1, with Claude Code 2.1.286 on Claude Opus 5.5 (one short prompt with and without the server connected, the difference read from the API's own usage figures) and Codex 0.159.3 on gpt-6.1-sol:

| Cost | 2.0.1 | 3.0.0 | | --- | --- | --- | | Claude Code, every tool loaded, every message | 89,024 | 88,384 | | Claude Code's default, tool search, every message | 3,223 | 3,224 | | SKILL.md, read once | 1,326 | 1,392 | | Codex over the CLI, one task, median of five | 86,664 | 83,060 | | Codex over MCP, the same task, median of five | 76,914 | 48,790 |

The task was "find the command that gets a TikTok video's transcript, and the flags it requires". Every tool loaded costs less, while the list a client receives grows by an approval marker on the 185 paid tools, which Claude Code does not pass to the model. Over the CLI, every 3.0.0 run asked which, a 478-character answer, where every 2.0.1 run read the 13,019-character command list. Over MCP, four 3.0.0 runs answered after printing part of the tool list, against two 2.0.1 runs, so the median fell; where both printed the whole list, they read about the same, 76,914 and 77,022. SKILL.md costs 66 more because it says how approval works over MCP and what exit codes 1 and 2 cover.

Tool-list bytes or characters divided by four are not API usage, and no other offering was measured.

8. Every tool and argument

The full current API catalogue and every argument below derive from actual stdio discovery. The API has 188 endpoint variants; the local helpers bring discovery to 190. Read-like POST requests retrieve data rather than publish social content. Query/body field names preserve the upstream schema, including native camelCase cursors.

| Tool | Route | Mode | | --- | --- | --- | | tiktok_profile | GET /v1/tiktok/profile | Potentially paid; confirm | | tiktok_profile_region | GET /v1/tiktok/profile/region | Potentially paid; confirm | | tiktok_audience_demographics | GET /v1/tiktok/user/audience | Potentially paid; confirm | | tiktok_collection_videos | GET /v1/tiktok/collection/videos | Potentially paid; confirm | | tiktok_profile_videos | GET /v3/tiktok/profile/videos | Potentially paid; confirm | | tiktok_video_info | GET /v2/tiktok/video | Potentially paid; confirm | | tiktok_transcript | GET /v1/tiktok/video/transcript | Potentially paid; confirm | | tiktok_live | GET /v1/tiktok/user/live | Potentially paid; confirm | | tiktok_live_info | GET /v1/tiktok/live | Potentially paid; confirm | | tiktok_comments | GET /v1/tiktok/video/comments | Potentially paid; confirm | | tiktok_comment_replies | GET /v1/tiktok/video/comment/replies | Potentially paid; confirm | | tiktok_following | GET /v1/tiktok/user/following | Potentially paid; confirm | | tiktok_followers | GET /v1/tiktok/user/followers | Potentially paid; confirm | | tiktok_search_users | GET /v1/tiktok/search/users | Potentially paid; confirm | | tiktok_search_suggestions | GET /v1/tiktok/search/suggestions | Potentially paid; confirm | | tiktok_search_by_hashtag | GET /v1/tiktok/search/hashtag | Potentially paid; confirm | | tiktok_search_by_keyword | GET /v1/tiktok/search/keyword | Potentially paid; confirm | | tiktok_top_search | GET /v1/tiktok/search/top | Potentially paid; confirm | | tiktok_get_popular_creators | GET /v1/tiktok/creators/popular | Potentially paid; confirm | | tiktok_get_song_details | GET /v1/tiktok/song | Potentially paid; confirm | | tiktok_tiktoks_using_song | GET /v1/tiktok/song/videos | Potentially paid; confirm | | tiktok_trending_feed | GET /v1/tiktok/get-trending-feed | Potentially paid; confirm | | tiktok_shop_shop_search | GET /v1/tiktok/shop/search | Potentially paid; confirm | | tiktok_shop_shop_products | GET /v1/tiktok/shop/products | Potentially paid; confirm | | tiktok_shop_product_details | GET /v1/tiktok/product | Potentially paid; confirm | | tiktok_shop_product_reviews | GET /v1/tiktok/shop/product/reviews | Potentially paid; confirm | | tiktok_shop_user_showcase | GET /v1/tiktok/user/showcase | Potentially paid; confirm | | instagram_profile | GET /v1/instagram/profile | Potentially paid; confirm | | instagram_basic_profile | GET /v1/instagram/basic-profile | Potentially paid; confirm | | instagram_posts | GET /v2/instagram/user/posts | Potentially paid; confirm | | instagram_user_tagged_posts | GET /v1/instagram/user/tagged-posts | Potentially paid; confirm | | instagram_reels | GET /v1/instagram/user/reels | Potentially paid; confirm | | instagram_post_reel_info | GET /v1/instagram/post | Potentially paid; confirm | | instagram_transcript | GET /v2/instagram/media/transcript | Potentially paid; confirm | | instagram_search_instagram | GET /v1/instagram/search | Potentially paid; confirm | | instagram_popular_search | GET /v1/instagram/search/popular | Potentially paid; confirm | | instagram_search_hashtag_posts | GET /v1/instagram/search/hashtag | Potentially paid; confirm | | instagram_search_instagram_profiles | GET /v1/instagram/search/profiles | Potentially paid; confirm | | instagram_search_reels | GET /v2/instagram/reels/search | Potentially paid; confirm | | instagram_get_reels_by_audio_id | GET /v1/instagram/audio/reels | Potentially paid; confirm | | instagram_trending_reels | GET /v1/instagram/reels/trending | Potentially paid; confirm | | instagram_comments | GET /v2/instagram/post/comments | Potentially paid; confirm | | instagram_comment_replies | GET /v1/instagram/post/comment/replies | Potentially paid; confirm | | instagram_story_highlights | GET /v1/instagram/user/highlights | Potentially paid; confirm | | instagram_highlights_details | GET /v1/instagram/user/highlight/detail | Potentially paid; confirm | | instagram_profile_post_count | GET /v1/instagram/profile/post-count | Potentially paid; confirm | | instagram_embed_html | GET /v1/instagram/user/embed | Potentially paid; confirm | | telegram_channel_details | GET /v1/telegram/channel | Potentially paid; confirm | | telegram_channel_posts | GET /v1/telegram/channel/posts | Potentially paid; confirm | | telegram_post_details | GET /v1/telegram/post | Potentially paid; confirm | | youtube_channel_details | GET /v1/youtube/channel | Potentially paid; confirm | | youtube_channel_videos | GET /v1/youtube/channel-videos | Potentially paid; confirm | | youtube_channel_playlists | GET /v1/youtube/channel/playlists | Potentially paid; confirm | | youtube_channel_lives | GET /v1/youtube/channel/lives | Potentially paid; confirm | | youtube_channel_community_posts | GET /v1/youtube/channel/community-posts | Potentially paid; confirm | | youtube_channel_shorts | GET /v1/youtube/channel/shorts | Potentially paid; confirm | | youtube_video_short_details | GET /v1/youtube/video | Potentially paid; confirm | | youtube_transcript | GET /v1/youtube/video/transcript | Potentially paid; confirm | | youtube_video_sponsors | GET /v1/youtube/video/sponsors | Potentially paid; confirm | | youtube_search | GET /v1/youtube/search | Potentially paid; confirm | | youtube_search_typeahead | GET /v1/youtube/search/typeahead | Potentially paid; confirm | | youtube_search_by_hashtag | GET /v1/youtube/search/hashtag | Potentially paid; confirm | | youtube_comments | GET /v1/youtube/video/comments | Potentially paid; confirm | | youtube_comment_replies | GET /v1/youtube/video/comment/replies | Potentially paid; confirm | | youtube_trending_shorts | GET /v1/youtube/shorts/trending | Potentially paid; confirm | | youtube_playlist | GET /v1/youtube/playlist | Potentially paid; confirm | | youtube_community_post_details | GET /v1/youtube/community-post | Potentially paid; confirm | | rumble_search | GET /v1/rumble/search | Potentially paid; confirm | | rumble_channel_videos | GET /v1/rumble/channel/videos | Potentially paid; confirm | | rumble_video | GET /v1/rumble/video | Potentially paid; confirm | | rumble_transcript | GET /v1/rumble/video/transcript | Potentially paid; confirm | | rumble_comments | GET /v1/rumble/video/comments | Potentially paid; confirm | | linkedin_person_profile | GET /v1/linkedin/profile | Potentially paid; confirm | | linkedin_company_page | GET /v1/linkedin/company | Potentially paid; confirm | | linkedin_company_posts | GET /v1/linkedin/company/posts | Potentially paid; confirm | | linkedin_search_posts | GET /v1/linkedin/search/posts | Potentially paid; confirm | | linkedin_post | GET /v1/linkedin/post | Potentially paid; confirm | | linkedin_post_transcript | GET /v1/linkedin/post/transcript | Potentially paid; confirm | | facebook_profile | GET /v1/facebook/profile | Potentially paid; confirm | | facebook_profile_reels | GET /v1/facebook/profile/reels | Potentially paid; confirm | | facebook_profile_photos | GET /v1/facebook/profile/photos | Potentially paid; confirm | | facebook_profile_posts | GET /v1/facebook/profile/posts | Potentially paid; confirm | | facebook_profile_events | GET /v1/facebook/profile/events | Potentially paid; confirm | | facebook_post | GET /v1/facebook/post | Potentially paid; confirm | | facebook_transcript | GET /v1/facebook/post/transcript | Potentially paid; confirm | | facebook_comments | GET /v1/facebook/post/comments | Potentially paid; confirm | | facebook_comment_replies | GET /v1/facebook/post/comment/replies | Potentially paid; confirm | | facebook_facebook_group_info | GET /v1/facebook/group | Potentially paid; confirm | | facebook_facebook_group_posts | GET /v1/facebook/group/posts | Potentially paid; confirm | | github_user | GET /v1/github/user | Potentially paid; confirm | | github_repositories | GET /v1/github/user/repositories | Potentially paid; confirm | | github_pull_requests | GET /v1/github/user/pull-requests | Potentially paid; confirm | | github_activity | GET /v1/github/user/activity | Potentially paid; confirm | | github_followers | GET /v1/github/user/followers | Potentially paid; confirm | | github_following | GET /v1/github/user/following | Potentially paid; confirm | | github_contributions | GET /v1/github/user/contributions | Potentially paid; confirm | | github_repository | GET /v1/github/repository | Potentially paid; confirm | | github_trending_repositories | GET /v1/github/trending/repositories | Potentially paid; confirm | | github_trending_developers | GET /v1/github/trending/developers | Potentially paid; confirm | | facebook_marketplace_marketplace_location_search | GET /v1/facebook/marketplace/location/search | Potentially paid; confirm | | facebook_marketplace_marketplace_search | GET /v1/facebook/marketplace/search | Potentially paid; confirm | | facebook_marketplace_marketplace_item | GET /v1/facebook/marketplace/item | Potentially paid; confirm | | facebook_events_search_events | GET /v1/facebook/events/search | Potentially paid; confirm | | facebook_events_events | GET /v1/facebook/events | Potentially paid; confirm | | facebook_events_event_details | GET /v1/facebook/event/details | Potentially paid; confirm | | facebook_ad_library_ad_details | GET /v1/facebook/adLibrary/ad | Potentially paid; confirm | | facebook_ad_library_ad_transcript | GET /v1/facebook/adLibrary/ad/transcript | Potentially paid; confirm | | facebook_ad_library_search | GET /v1/facebook/adLibrary/search/ads | Potentially paid; confirm | | facebook_ad_library_search_post | POST /v1/facebook/adLibrary/search/ads | Potentially paid; confirm | | facebook_ad_library_company_ads | GET /v1/facebook/adLibrary/company/ads | Potentially paid; confirm | | facebook_ad_library_company_ads_post | POST /v1/facebook/adLibrary/company/ads | Potentially paid; confirm | | facebook_ad_library_search_for_companies | GET /v1/facebook/adLibrary/search/companies | Potentially paid; confirm | | tiktok_ad_library_ad_library_search | GET /v1/tiktok/ad-library/search | Potentially paid; confirm | | tiktok_ad_library_ad_library_ad | GET /v1/tiktok/ad-library/ad | Potentially paid; confirm | | google_ad_library_company_ads | GET /v1/google/company/ads | Potentially paid; confirm | | google_ad_library_ad_details | GET /v1/google/ad | Potentially paid; confirm | | google_ad_library_advertiser_search | GET /v1/google/adLibrary/advertisers/search | Potentially paid; confirm | | linkedin_ad_library_search_ads | GET /v1/linkedin/ads/search | Potentially paid; confirm | | linkedin_ad_library_ad_details | GET /v1/linkedin/ad | Potentially paid; confirm | | twitter_profile | GET /v1/twitter/profile | Potentially paid; confirm | | twitter_user_tweets | GET /v1/twitter/user-tweets | Potentially paid; confirm | | twitter_tweet_details | GET /v1/twitter/tweet | Potentially paid; confirm | | twitter_transcript | GET /v1/twitter/tweet/transcript | Potentially paid; confirm | | twitter_community | GET /v1/twitter/community | Potentially paid; confirm | | twitter_community_tweets | GET /v1/twitter/community/tweets | Potentially paid; confirm | | reddit_subreddit_details | GET /v1/reddit/subreddit/details | Potentially paid; confirm | | reddit_subreddit_posts | GET /v1/reddit/subreddit | Potentially paid; confirm | | reddit_subreddit_search | GET /v1/reddit/subreddit/search | Potentially paid; confirm | | reddit_post | GET /v1/reddit/post | Potentially paid; confirm | | reddit_post_comments | GET /v1/reddit/post/comments | Potentially paid; confirm | | reddit_post_comments_post | POST /v1/reddit/post/comments | Potentially paid; confirm | | reddit_post_transcript | GET /v1/reddit/post/transcript | Potentially paid; confirm | | reddit_search | GET /v1/reddit/search | Potentially paid; confirm | | truth_social_profile | GET /v1/truthsocial/profile | Potentially paid; confirm | | truth_social_user_posts | GET /v1/truthsocial/user/posts | Potentially paid; confirm | | truth_social_post | GET /v1/truthsocial/post | Potentially paid; confirm | | threads_profile | GET /v1/threads/profile | Potentially paid; confirm | | threads_posts | GET /v1/threads/user/posts | Potentially paid; confirm | | threads_post | GET /v1/threads/post | Potentially paid; confirm | | threads_search_by_keyword | GET /v1/threads/search | Potentially paid; confirm | | threads_search_users | GET /v1/threads/search/users | Potentially paid; confirm | | bluesky_profile | GET /v1/bluesky/profile | Potentially paid; confirm | | bluesky_posts | GET /v1/bluesky/user/posts | Potentially paid; confirm | | bluesky_post | GET /v1/bluesky/post | Potentially paid; confirm | | pinterest_search | GET /v1/pinterest/search | Potentially paid; confirm | | pinterest_pin | GET /v1/pinterest/pin | Potentially paid; confirm | | pinterest_user_boards | GET /v1/pinterest/user/boards | Potentially paid; confirm | | pinterest_board | GET /v1/pinterest/board | Potentially paid; confirm | | google_search | GET /v1/google/search | Potentially paid; confirm | | twitch_profile | GET /v1/twitch/profile | Potentially paid; confirm | | twitch_user_videos | GET /v1/twitch/user/videos | Potentially paid; confirm | | twitch_user_schedule | GET /v1/twitch/user/schedule | Potentially paid; confirm | | twitch_clip_transcript | GET /v1/twitch/clip/transcript | Potentially paid; confirm | | twitch_clip | GET /v1/twitch/clip | Potentially paid; confirm | | apple_music_artist | GET /v1/apple-music/artist | Potentially paid; confirm | | apple_music_album | GET /v1/apple-music/album | Potentially paid; confirm | | apple_music_track | GET /v1/apple-music/track | Potentially paid; confirm | | apple_music_search | GET /v1/apple-music/search | Potentially paid; confirm | | spotify_artist | GET /v1/spotify/artist | Potentially paid; confirm | | spotify_track | GET /v1/spotify/track | Potentially paid; confirm | | spotify_album | GET /v1/spotify/album | Potentially paid; confirm | | spotify_playlist | GET /v1/spotify/playlist | Potentially paid; confirm | | spotify_search | GET /v1/spotify/search | Potentially paid; confirm | | spotify_podcast | GET /v1/spotify/podcast | Potentially paid; confirm | | spotify_podcast_episodes | GET /v1/spotify/podcast/episodes | Potentially paid; confirm | | soundcloud_artist | GET /v1/soundcloud/artist | Potentially paid; confirm | | soundcloud_artist_tracks | GET /v1/soundcloud/artist/tracks | Potentially paid; confirm | | soundcloud_track | GET /v1/soundcloud/track | Potentially paid; confirm | | kwai_profile | GET /v1/kwai/profile | Potentially paid; confirm | | kwai_user_posts | GET /v1/kwai/user/posts | Potentially paid; confirm | | kwai_post | GET /v1/kwai/post | Potentially paid; confirm | | kick_clip_transcript | GET /v1/kick/clip/transcript | Potentially paid; confirm | | kick_clip | GET /v1/kick/clip | Potentially paid; confirm | | snapchat_user_profile | GET /v1/snapchat/profile | Potentially paid; confirm | | snapchat_spotlight_by_link | GET /v1/snapchat/spotlight | Potentially paid; confirm | | snapchat_spotlight_comments_by_link | GET /v1/snapchat/spotlight/comments | Potentially paid; confirm | | creator_tools_find_social_profiles | GET /v1/find-social-profiles | Potentially paid; confirm | | creator_tools_get_age_and_gender | GET /v1/detect-age-gender | Potentially paid; confirm | | linktree_linktree_page | GET /v1/linktree | Potentially paid; confirm | | komi_komi_page | GET /v1/komi | Potentially paid; confirm | | pillar_pillar_page | GET /v1/pillar | Potentially paid; confirm | | linkbio_linkbio_page | GET /v1/linkbio | Potentially paid; confirm | | amazon_shop_amazon_shop_page | GET /v1/amazon/shop | Potentially paid; confirm | | scrapecreators_get_credit_balance | GET /v1/account/credit-balance | Account metadata read | | scrapecreators_get_request_history | GET /v1/account/get-api-usage | Account metadata read | | scrapecreators_get_daily_usage | GET /v1/account/get-daily-usage-count | Account metadata read | | scrapecreators_get_most_used_routes | GET /v1/account/get-most-used-routes | Account metadata read | | linkme_profile | GET /v1/linkme | Potentially paid; confirm | | list_accounts | Local, no network | Read | | research_batch | Local sequential workflow | Confirmed paid research |

tiktok_profile

scrapecreators-cli tiktok-profile

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | No; body/guard rules apply | string | TikTok handle. You can pass handle or user_id. | | user_id | No; body/guard rules apply | string | TikTok user id. | | cache_max_age | No; body/guard rules apply | string | Maximum acceptable provider-cache age; a miss may consume the normal endpoint credits. Values: 1d, 3d, 7d, 14d, 30d. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

Provide handle or user_id; an empty selector is rejected before a network call.

tiktok_profile_region

scrapecreators-cli tiktok-profile-region

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | TikTok handle | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_audience_demographics

scrapecreators-cli tiktok-audience-demographics

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | TikTok handle | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_collection_videos

scrapecreators-cli tiktok-collection-videos

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | Public TikTok collection URL | | cursor | No; body/guard rules apply | string | Cursor to get more videos. Use max_cursor from the previous response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_profile_videos

scrapecreators-cli tiktok-profile-videos

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | TikTok handle | | user_id | No; body/guard rules apply | string | TikTok user id. Use this for faster responses. | | sort_by | No; body/guard rules apply | string | What to sort by Values: latest, popular. | | max_cursor | No; body/guard rules apply | string | Cursor to get more videos. Get 'max_cursor' from previous response. | | region | No; body/guard rules apply | string | Region (country) for the proxy. Defaults to GB. If a profile should have videos but returns none, try US or another relevant two-letter country code. | | trim | No; body/guard rules apply | boolean | Set to true for a trimmed down version of the response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_video_info

scrapecreators-cli tiktok-video-info

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | TikTok video URL | | get_transcript | No; body/guard rules apply | boolean | Get transcript of the video | | region | No; body/guard rules apply | string | Region of the proxy. Sometimes you'll need to specify the region if you're not getting a response. Commonly for videos from the Phillipines, in which case you'd use 'PH'. Use 2 letter country codes like US, GB, FR, etc | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | download_media | No; body/guard rules apply | boolean | Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise. | | cache_max_age | No; body/guard rules apply | string | Maximum acceptable provider-cache age; a miss may consume the normal endpoint credits. Values: 1d, 3d, 7d, 14d, 30d. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_transcript

scrapecreators-cli tiktok-transcript

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | TikTok video URL | | language | No; body/guard rules apply | string | Language of the transcript. 2 letter language code, ie 'en', 'es', 'fr', 'de', 'it', 'ja', 'ko', 'zh' | | use_ai_as_fallback | No; body/guard rules apply | string | Set to 'true' to use AI when an existing transcript is not found. The AI fallback supports videos up to 2 minutes and costs 10 credits; existing transcripts have no length limit. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_live

scrapecreators-cli tiktok-live

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | TikTok handle | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_live_info

scrapecreators-cli tiktok-live-info

| Argument | Required | Type | Details | | --- | --- | --- | --- | | room_id | Yes | string | TikTok live room id. Get this from /v1/tiktok/user/live in liveRoomUserInfo.roomId or liveRoom.id when the user is live. | | user_id | Yes | string | TikTok numeric user id for the live owner. Get this from /v1/tiktok/profile in user.id. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_comments

scrapecreators-cli tiktok-comments

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | TikTok video URL | | cursor | No; body/guard rules apply | number | Cursor to get more comments. Get 'cursor' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_comment_replies

scrapecreators-cli tiktok-comment-replies

| Argument | Required | Type | Details | | --- | --- | --- | --- | | comment_id | Yes | string | TikTok comment ID. This is the cid from the comments endpoint. | | url | Yes | string | TikTok video URL. This is the url from the comments endpoint. | | cursor | No; body/guard rules apply | number | Cursor to get more replies. Get 'cursor' from previous response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_following

scrapecreators-cli tiktok-following

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | TikTok handle | | min_time | No; body/guard rules apply | number | Used to paginate. Get 'min_time' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_followers

scrapecreators-cli tiktok-followers

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | No; body/guard rules apply | string | TikTok handle | | user_id | No; body/guard rules apply | string | User id. Use this for faster response times. | | min_time | No; body/guard rules apply | number | Used to paginate. Get 'min_time' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_search_users

scrapecreators-cli tiktok-search-users

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | Search query for users | | cursor | No; body/guard rules apply | number | Cursor to get more users. Get 'cursor' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_search_suggestions

scrapecreators-cli tiktok-search-suggestions

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | Search query to get suggestions for | | region | No; body/guard rules apply | string | Region code for suggestions | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_search_by_hashtag

scrapecreators-cli tiktok-search-by-hashtag

| Argument | Required | Type | Details | | --- | --- | --- | --- | | hashtag | Yes | string | Hashtag to search for (without #) | | region | No; body/guard rules apply | string | Region the proxy will be set to. Note: this isn't going to grab you all tiktoks from this region, you're just setting the proxy there. | | cursor | No; body/guard rules apply | number | Cursor to get more videos. Get 'cursor' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_search_by_keyword

scrapecreators-cli tiktok-search-by-keyword

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | Keyword to search for | | date_posted | No; body/guard rules apply | string | Time Frame Values: yesterday, this-week, this-month, last-3-months, last-6-months, all-time. | | sort_by | No; body/guard rules apply | string | Sort by Values: relevance, most-liked, date-posted. | | region | No; body/guard rules apply | string | Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc | | cursor | No; body/guard rules apply | number | Cursor to get more videos. Get 'cursor' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_top_search

scrapecreators-cli tiktok-top-search

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | Keyword to search for | | publish_time | No; body/guard rules apply | string | Time Frame TikTok was posted Values: yesterday, this-week, this-month, last-3-months, last-6-months, all-time. | | sort_by | No; body/guard rules apply | string | Sort by Values: relevance, most-liked, date-posted. | | region | No; body/guard rules apply | string | Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc | | cursor | No; body/guard rules apply | number | Cursor to get more videos. Get 'cursor' from previous response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_get_popular_creators

scrapecreators-cli tiktok-get-popular-creators

| Argument | Required | Type | Details | | --- | --- | --- | --- | | page | No; body/guard rules apply | number | Page number | | sortBy | No; body/guard rules apply | string | Sort creators by engagement, follower count, or average views Values: engagement, follower, avg_views. | | followerCount | No; body/guard rules apply | string | Filter by follower count range Values: 10K-100K, 100K-1M, 1M-10M, 10M+. | | creatorCountry | No; body/guard rules apply | string | Country code of the creator Values: AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN. | | audienceCountry | No; body/guard rules apply | string | Country code of the audience/follower Values: AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_get_song_details

scrapecreators-cli tiktok-get-song-details

| Argument | Required | Type | Details | | --- | --- | --- | --- | | clipId | Yes | string | This is a little confusing because this isn't songId like you'd think. It is the clipId. I guess because you can clip different portions of a song 🤷‍♂️ | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_tiktoks_using_song

scrapecreators-cli tiktok-tiktoks-using-song

| Argument | Required | Type | Details | | --- | --- | --- | --- | | clipId | No; body/guard rules apply | string | This is clipId. Can be found on a url like so: https://www.tiktok.com/music/That%27s-Who-I-Praise-7370375686554782506, where 7370375686554782506 is the clipId | | cursor | No; body/guard rules apply | number | The cursor to get the next page of results. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_trending_feed

scrapecreators-cli tiktok-trending-feed

| Argument | Required | Type | Details | | --- | --- | --- | --- | | region | Yes | string | Where you want the proxy to be. This doesn't mean that you will only see TikToks from this region, you will just see the content that isn't banned in that region. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_shop_shop_search

scrapecreators-cli tiktok-shop-shop-search

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | Term you want to search for | | page | No; body/guard rules apply | number | Page number to retrieve | | region | No; body/guard rules apply | string | Region to search shop products in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent results. Sorry for the inconvenience. Values: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_shop_shop_products

scrapecreators-cli tiktok-shop-shop-products

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | The TikTok Shop store URL. | | cursor | No; body/guard rules apply | string | Cursor parameter from the previous response to retrieve the next page of products. Omit for the first page. | | sort_by | No; body/guard rules apply | string | Sort products by best-selling items (top) or newest products (new_releases). Defaults to top. Values: top, new_releases. | | region | No; body/guard rules apply | string | Region to get shop products from. Defaults to US if not provided. Non-US regions are not reliable right now and may return not_found or limited catalog data even when the shop appears in search. Sorry for the inconvenience. Values: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_shop_product_details

scrapecreators-cli tiktok-shop-product-details

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | The URL of the product to get details for. | | region | No; body/guard rules apply | string | Region for the product details request. US is the reliable region right now; non-US regions should not be considered reliable and may return bad_request or missing product data. Sorry for the inconvenience. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_shop_product_reviews

scrapecreators-cli tiktok-shop-product-reviews

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | No; body/guard rules apply | string | The URL of the product (required if product_id is not provided) | | product_id | No; body/guard rules apply | string | The ID of the product (required if url is not provided) | | region | No; body/guard rules apply | string | The region of the product. US is the reliable region right now; non-US regions should not be considered reliable and may return limited or inconsistent review data. Sorry for the inconvenience. | | page | No; body/guard rules apply | number | The page number of the reviews | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

tiktok_shop_user_showcase

scrapecreators-cli tiktok-shop-user-showcase

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | The handle of the user | | region | No; body/guard rules apply | string | Region to put the proxy in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent showcase data. Sorry for the inconvenience. | | cursor | No; body/guard rules apply | string | The cursor to the next page of products | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_profile

scrapecreators-cli instagram-profile

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | Instagram handle | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | cache_max_age | No; body/guard rules apply | string | Maximum acceptable provider-cache age; a miss may consume the normal endpoint credits. Values: 1d, 3d, 7d, 14d, 30d. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_basic_profile

scrapecreators-cli instagram-basic-profile

| Argument | Required | Type | Details | | --- | --- | --- | --- | | userId | No; body/guard rules apply | string | Instagram user id | | cache_max_age | No; body/guard rules apply | string | Maximum acceptable provider-cache age; a miss may consume the normal endpoint credits. Values: 1d, 3d, 7d, 14d, 30d. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_posts

scrapecreators-cli instagram-posts

| Argument | Required | Type | Details | | --- | --- | --- | --- | | handle | Yes | string | Instagram handle | | next_max_id | No; body/guard rules apply | string | Cursor to get next page of results. | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_user_tagged_posts

scrapecreators-cli instagram-user-tagged-posts

| Argument | Required | Type | Details | | --- | --- | --- | --- | | user_id | Yes | string | Numeric Instagram user ID. | | cursor | No; body/guard rules apply | string | Cursor returned by the previous response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_reels

scrapecreators-cli instagram-reels

| Argument | Required | Type | Details | | --- | --- | --- | --- | | user_id | No; body/guard rules apply | string | Instagram user id. Use this for faster response times. | | handle | No; body/guard rules apply | string | Instagram handle. Use user_id for faster response times. | | max_id | No; body/guard rules apply | string | Max id to get more reels. Get 'max_id' from previous response. | | trim | No; body/guard rules apply | boolean | Set to true for a trimmed down version of the response | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_post_reel_info

scrapecreators-cli instagram-post-reel-info

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | Instagram post or reel URL | | region | No; body/guard rules apply | string | 2 letter country code to set the proxy in | | trim | No; body/guard rules apply | boolean | Set to true to get a trimmed response | | download_media | No; body/guard rules apply | boolean | Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise. | | include_play_count | No; body/guard rules apply | boolean | Set to false to omit video_play_count and skip its additional fetch for a faster response. Defaults to true. | | cache_max_age | No; body/guard rules apply | string | Maximum acceptable provider-cache age; a miss may consume the normal endpoint credits. Values: 1d, 3d, 7d, 14d, 30d. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_transcript

scrapecreators-cli instagram-transcript

| Argument | Required | Type | Details | | --- | --- | --- | --- | | url | Yes | string | Instagram post or reel URL | | cache_max_age | No; body/guard rules apply | string | Maximum acceptable provider-cache age; a miss may consume the normal endpoint credits. Values: 1d, 3d, 7d, 14d, 30d. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_search_instagram

scrapecreators-cli instagram-search-instagram

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | The username, hashtag, place, or keyword to search for. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_popular_search

scrapecreators-cli instagram-popular-search

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | The Popular topic to search for. | | cursor | No; body/guard rules apply | string | The opaque cursor returned by the previous response. Use it with the same query to fetch the next page of posts. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_search_hashtag_posts

scrapecreators-cli instagram-search-hashtag-posts

| Argument | Required | Type | Details | | --- | --- | --- | --- | | hashtag | Yes | string | The hashtag to search for. Include or omit the #. | | date_posted | No; body/guard rules apply | string | Only return Google-indexed posts found in this relative window. Values: last-hour, last-day, last-week, last-month, last-year. | | media_type | No; body/guard rules apply | string | Use all to search public posts and reels, or reels to only return reels. Defaults to all. Values: all, reels. | | cursor | No; body/guard rules apply | string | The cursor returned by the previous response. It is the next Google results page number and cannot exceed 11; cursor 12 or greater returns a 400 response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_search_instagram_profiles

scrapecreators-cli instagram-search-instagram-profiles

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | The profile name or username to search for. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_search_reels

scrapecreators-cli instagram-search-reels

| Argument | Required | Type | Details | | --- | --- | --- | --- | | query | Yes | string | The keyword to search for | | date_posted | No; body/guard rules apply | string | Google-indexed date window. Recent hour/day filters are not supported because Google does not index Instagram reels reliably enough in those windows. Values: last-week, last-month, last-year. | | page | No; body/guard rules apply | number | The page number to return. Must be between 1 and 11; page 12 or greater returns a 400 response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_get_reels_by_audio_id

scrapecreators-cli instagram-get-reels-by-audio-id

| Argument | Required | Type | Details | | --- | --- | --- | --- | | audio_id | Yes | string | The audio id from the Instagram audio page URL. | | cursor | No; body/guard rules apply | string | Pagination cursor returned by Instagram from the previous response. | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boolean | Set true only when the user asked for exactly this action. |

instagram_trending_reels

scrapecreators-cli instagram-trending-reels

| Argument | Required | Type | Details | | --- | --- | --- | --- | | account | No; body/guard rules apply | string | Named private ScrapeCreators account; selects credentials, not a remote account ID. | | confirm | No; body/guard rules apply | boole