Fetchproof MCP Server
Provides tools for retrieving Facebook pages and posts, including public data and Ad Library-related capabilities.
Provides tools for accessing Instagram profiles, grid posts, reels, and individual posts.
Provides tools for querying the Meta Ad Library to retrieve advertising data.
Provides tools for TikTok profiles, profile videos, individual videos, comments, transcripts, and search.
Provides tools for YouTube channels, videos, comments, and transcripts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Fetchproof MCP Server fetch the transcript for this YouTube video: https://youtu.be/dQw4w9WgXcQ"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@fetchproof/mcp
stdio Model Context Protocol server for the Fetchproof public-data API. Each published operation is one tool — TikTok, Instagram, Facebook (including the Ad Library), YouTube transcripts, official race results by bib, and the rest of the catalog.
You bring your own Fetchproof API key (FETCHPROOF_API_KEY). No key is embedded in this package. initialize and tools/list work without a key so clients and directories can inspect the tool list.
Docs: docs.fetchproof.com/mcp · Free tools: fetchproof.com/tools · Sign up: app.fetchproof.com
Install
Node 20 or newer. No install is required if you use npx:
FETCHPROOF_API_KEY=fp_your_key npx -y @fetchproof/mcpOr install the CLI:
npm install -g @fetchproof/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"fetchproof": {
"command": "npx",
"args": ["-y", "@fetchproof/mcp"],
"env": {
"FETCHPROOF_API_KEY": "fp_your_key"
}
}
}
}Cursor (.cursor/mcp.json or a stdio MCP entry)
{
"mcpServers": {
"fetchproof": {
"command": "npx",
"args": ["-y", "@fetchproof/mcp"],
"env": {
"FETCHPROOF_API_KEY": "fp_your_key"
}
}
}
}A hosted Streamable HTTP endpoint also exists at https://api.fetchproof.com/mcp (send the key as Authorization: Bearer or x-api-key). This package is the local stdio server: it maps tools from the published OpenAPI operations and calls the REST API directly.
Related MCP server: SocialToAI MCP Server
Environment
Variable | Required | Default | Purpose |
| For | — | Your key from app.fetchproof.com |
| No |
| API host |
| No |
| Per-request timeout |
Billing
Prepaid, one-time credit packs. 1 credit per call by default. Credits never expire. There is no subscription.
Freelance: $27 for 25,000 credits
Business: $297 for 500,000 credits
Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Each tool description includes that operation's published credit cost, including any empty-result or outcome rules.
What this server can do
One tool per published operation. Priority surfaces include:
TikTok profiles, profile videos, individual videos, comments, transcripts, search
Instagram profiles, grid posts, reels, individual posts
Facebook pages, posts, and the Meta Ad Library
YouTube channels, videos, comments, and transcripts
Official race results by bib (RunSignup, Athlinks/ChronoTrack, Race Roster)
The tool list stays in sync with the published OpenAPI file in this repository. Held-back or unpublished routes are not tools.
Development
node mcp/scripts/sync-spec.mjs # regenerate openapi/tools.json from the published spec
node mcp/test/mcp-package.test.js
npm pack --dry-run --prefix mcpThis package has no runtime dependencies. Logs go to stderr; stdout is JSON-RPC only (newline-delimited; Content-Length framing is also accepted).
License
MIT
Available Tools
133 toolsaccount_credit_balanceA
account: Get credit balance. GET /v1/account/credit-balance. Call it with no arguments. Get your remaining credit balance. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: no named parameters.
account_get_api_usageA
account: Get request history. GET /v1/account/get-api-usage. Call it with no arguments for the recent page. endpoint, statusCode and page are optional filters. View your recent API request history Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: page, endpoint, statusCode.
account_get_daily_usage_countA
account: Get daily usage. GET /v1/account/get-daily-usage-count. Call it with no arguments. Each row is one day. Get your daily credit and request counts Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: no named parameters.
account_get_most_used_routesA
account: Get most used routes. GET /v1/account/get-most-used-routes. Call it with no arguments for the default window. start_time and end_time are optional ISO-8601 bounds. See which endpoints you use the most Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: end_time, start_time.
apple_music_albumB
apple-music: Album. GET /v1/apple-music/album. Provide one of: id, url. Get Apple Music album Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
apple_music_artistB
apple-music: Artist. GET /v1/apple-music/artist. Provide one of: id, url. Get Apple Music artist Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
apple_music_searchB
apple-music: Search. GET /v1/apple-music/search. Search Apple Music Costs 1 credit when it succeeds. Costs 0 credits when sections is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), type.
apple_music_trackB
apple-music: Track. GET /v1/apple-music/track. Provide one of: id, url. Get Apple Music track Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
bilibili_userB
bilibili: User profile. GET /v1/bilibili/user. Public profile card for a numeric user id. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: mid (required), cache_max_age.
bluesky_postB
bluesky: Post. GET /v1/bluesky/post. Get Bluesky post Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required).
bluesky_profileB
bluesky: Profile. GET /v1/bluesky/profile. Provide one of: handle, user_id. Get Bluesky profile info Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required).
bluesky_user_postsB
bluesky: Posts. GET /v1/bluesky/user/posts. Provide one of: handle, user_id. Get Bluesky user posts. Use user_id for faster response times. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle, user_id.
cosmos_clusterC
cosmos: Collection. GET /v1/cosmos/cluster. Get a public Cosmos collection with its owner, description, cover, counts, and public subcollections. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required).
cosmos_cluster_postsA
cosmos: Collection Posts. GET /v1/cosmos/cluster/posts. Get public posts saved to a Cosmos collection. Supports cursor pagination. Costs 1 credit when it succeeds. Costs 0 credits when items is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cursor.
cosmos_profileA
cosmos: Profile. GET /v1/cosmos/profile. Get a public Cosmos profile with bio, links, and follower counts. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required).
cosmos_searchA
cosmos: Search. GET /v1/cosmos/search. Search public Cosmos posts by keyword. Cosmos may return related posts even when there is no exact keyword match. Costs 1 credit when it succeeds. Costs 0 credits when items is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), cursor.
cosmos_user_clustersB
cosmos: User Collections. GET /v1/cosmos/user/clusters. Get the public collections owned by a Cosmos user. Costs 1 credit when it succeeds. Costs 0 credits when items is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cursor.
cosmos_user_postsA
cosmos: User Posts. GET /v1/cosmos/user/posts. Get the public posts saved to a Cosmos user profile. Costs 1 credit when it succeeds. Costs 0 credits when items is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cursor.
facebook_adLibrary_adA
facebookAdLibrary: Ad Details. GET /v1/facebook/adLibrary/ad. Get one Facebook Ad Library ad by its Library ID or ads/library/?id= URL, active or inactive. Returns adArchiveID, pageName, isActive, startDate, endDate, publisherPlatform and the snapshot (body, cards, images, videos, display_format, link_url, cta_text), with the advertiser's pageInfo and, for ads shown in the EU, aaa_info audience data. An ad no longer in the library is a 404. Ids are strings. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url, trim, cache_max_age, +2 more.
facebook_adLibrary_company_adsA
facebookAdLibrary: Company Ads. GET /v1/facebook/adLibrary/company/ads. Provide one of: pageId, companyName. A company's ads from its Ad Library page, with the same filters as ad search. Returns results and a cursor. An empty page costs 0 credits, and an unknown companyName is a 404 at 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when results is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: cursor, pageId, status, country, +6 more.
facebook_adLibrary_search_adsA
facebookAdLibrary: Search. GET /v1/facebook/adLibrary/search/ads. Search the Meta Ad Library by keyword, with the Ad Library's own filters: country, language, status, media type, ad type, exact phrase, sort, and an impressions date range. Returns searchResults (one card per creative group, as the Ad Library shows them: ad_archive_id, page_name, is_active, publisher_platform, collation_count, start/end dates and a snapshot with body text, images, videos, cards and cta_text), searchR Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), trim, cursor, status, +8 more.
facebook_adLibrary_search_companiesA
facebookAdLibrary: Search for Companies. GET /v1/facebook/adLibrary/search/companies. Search Ad Library pages by name and get each page id for /v1/facebook/adLibrary/company/ads, with likes and Instagram details. An empty result costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when searchResults is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required).
facebook_event_detailsA
facebook: Event Details. GET /v1/facebook/event/details. Get a public Facebook event by its URL or id: name, description, start and end time, place, address, coordinates, hosts, attendance and interested counts. going_count is not on the logged-out page and is omitted. Deleted and private events redirect to a login and fail at 0 credits. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
facebook_postA
facebook: Post. GET /v1/facebook/post. Get a public Facebook reel or video by URL (/reel/, /watch?v=, //videos/ and share links). Returns post_id, like_count (all reactions), comment_count, share_count, description, creation_time, the video's SD and HD URLs, author and sound. view_count is included only when the public page shows it; logged-out reel pages usually do not. shared_post_id and shared_post_url are null. Posts that Facebook only shows to Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cache_max_age, get_transcript, allow_long_transcription.
facebook_post_transcriptA
facebook: Transcript. GET /v1/facebook/post/transcript. Get a public Facebook reel or video's own captions as text and timed segments. No paid transcription. No captions costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when transcript is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cache_max_age.
facebook_profileA
facebook: Profile. GET /v1/facebook/profile. Get a public Facebook page's profile, as a signed-out visitor sees it: id, name, adLibrary.pageId (the id the Ad Library uses), exact followerCount and talkingAboutCount, category, intro, address, phone, email, website, services, price range, rating, and the cover and profile photos. adLibrary.adStatus, creationDate and businessHours are not on the signed-out page and are omitted; likeCount appears only when the page Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cache_max_age, get_business_hours, include_gated_profile.
facebook_profile_eventsA
facebook: Profile Events. GET /v1/facebook/profile/events. Get a public Facebook page's upcoming events, 8 per page, in the order Facebook lists them. total_count is the page's upcoming-event count. Pass cursor from a response, with the same url, for the next page. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cursor.
facebook_profile_postsA
facebook: Profile Posts. GET /v1/facebook/profile/posts. Get a public Facebook page's timeline posts, 3 per page, newest first, as a signed-out visitor sees them: id, text, url, author, reactionCount, commentCount, shareCount, publishTime, and SD/HD video URLs with a thumbnail for videos and reels. Provide url or pageId (the id from /v1/facebook/profile). topComments is always empty and videoViewCount is null: the signed-out feed does not carry them. Pass cursor from a res Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, cursor, pageId.
github_repositoryB
github: Repository. GET /v1/github/repository. Get public metadata for one GitHub repository. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required).
github_trending_developersA
github: Trending Developers. GET /v1/github/trending/developers. Get GitHub trending developers. Supports language and daily/weekly/monthly range filters. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: since, language.
github_trending_repositoriesA
github: Trending Repositories. GET /v1/github/trending/repositories. Get GitHub trending repositories. Supports language, spoken_language_code, and daily/weekly/monthly range filters. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: since, language, spoken_language_code.
github_userA
github: User. GET /v1/github/user. Provide one of: handle, url. Get public GitHub user details for a user. Pass username, handle, or url. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, handle.
github_user_activityA
github: Activity. GET /v1/github/user/activity. Provide one of: handle, url. Get public GitHub profile contribution activity for a user. Defaults to the current year and returns one month at a time. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, year, cursor, handle.
github_user_contributionsA
github: Contributions. GET /v1/github/user/contributions. Provide one of: handle, url. Get a user's GitHub contribution graph for a year. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, year, handle.
github_user_followersB
github: Followers. GET /v1/github/user/followers. Provide one of: handle, url. Get public followers for a GitHub user. Pass username, handle, or url. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, cursor, handle.
github_user_followingA
github: Following. GET /v1/github/user/following. Provide one of: handle, url. Get public accounts a GitHub user follows. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, cursor, handle.
github_user_pull_requestsA
github: Pull Requests. GET /v1/github/user/pull-requests. Get public pull requests authored by a GitHub user. Filter by created date with since and until. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), since, until, cursor.
github_user_repositoriesA
github: Repositories. GET /v1/github/user/repositories. Provide one of: handle, url. Get public repositories for a GitHub user. Supports pagination and GitHub's repo sorting options. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, sort, type, cursor, +2 more.
google_adLibrary_advertisers_searchB
googleAdLibrary: Advertiser Search. GET /v1/google/adLibrary/advertisers/search. Search the Google Ad Transparency Library for advertisers to get their advertiser id. Pass region for non-US advertisers, like AU or CA. Costs 1 credit when it succeeds. Costs 1 credit when websites is not empty. Costs 1 credit when advertisers is not empty. Costs 0 credits when advertisers is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), region.
google_company_adsA
googleAdLibrary: Company Ads. GET /v1/google/company/ads. Provide one of: advertiser_id, domain. Get public company ads with dates when available (1 credit). Set get_ad_details=true for full details (25 credits). firstShown can be null in detail responses even when the default list has it. Costs 1 credit when it succeeds. Costs 25 credits when get_ad_details is set. Costs 0 credits when ads is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: topic, cursor, domain, format, +6 more.
instagram_postA
instagram: Post/Reel Info. GET /v1/instagram/post. Get a public Instagram post or reel by URL (/p/, /reel/, /reels/ or /tv/), as a signed-out visitor sees it: media URLs, caption, owner (with follower count), like and comment counts, duration, music, date and location. video_view_count is Instagram's older view count; for the plays Instagram shows on a reel, set include_play_count=true. Comment edges are empty (comments need a login). Private or removed posts fail at Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, region, cache_max_age, +2 more.
instagram_profileA
instagram: Profile. GET /v1/instagram/profile. Get a public Instagram profile as a signed-out visitor sees it, in the web_profile_info shape under data.user: id, fbid, username, full name, biography, bio links, exact follower and following counts, verification, profile picture, and the profile grid's first 12 posts (edge_owner_to_timeline_media.edges). edge_owner_to_timeline_media.count is exact when Instagram shows the full number and null when it shows a rounde Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), trim, cache_max_age.
instagram_profile_post_countA
instagram: Profile Post Count. GET /v1/instagram/profile/post-count. Get a public profile's post count. It is exact when the profile's embed or page shows the full number (is_estimated false). When Instagram shows only a rounded value such as 1.2M, set allow_estimated=true to get the scaled number with is_estimated true; without it the call returns an uncharged 422. Missing profiles fail at 0 credits. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), allow_estimated.
instagram_reels_trendingA
instagram: Trending Reels. GET /v1/instagram/reels/trending. Get the reels Instagram's signed-out Reels feed (instagram.com/reels/) is showing right now, usually 8: shortcode, URL, caption, publication date (taken_at as ISO 8601, taken_at_timestamp in seconds), video and image URLs, like and comment counts, audio info and the creator. This is Instagram's own signed-out feed, not a ranked global chart, and repeated calls can overlap. Play counts are not in this feed: play_count Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: no named parameters.
instagram_search_popularA
instagram: Popular Search. GET /v1/instagram/search/popular. Get Instagram's public Popular page for a topic (instagram.com/popular//), as a signed-out visitor sees it: the page title, its rounded reel count (total_media_count, as Instagram rounds it), Instagram's topic summary with sources, related search terms, and the first 12 posts with play counts and creators. The query is turned into the page's path ("best pizza in chicago" → /popular/best-pizza-in-chicago/). Ins Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), cursor.
instagram_user_embedA
instagram: Embed HTML. GET /v1/instagram/user/embed. Get the HTML of an Instagram profile's embed widget (instagram.com//embed/). Profiles that are private, missing or not embeddable fail at 0 credits. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required).
instagram_user_highlight_detailA
instagram: Highlights Details. GET /v1/instagram/user/highlight/detail. Get a story highlight's stories by highlight id (the id from /v1/instagram/user/highlights): id, user, latest_reel_media and items, each with image_versions2 and, for videos, video_versions. Ids past 2^53 (pk) are strings. The title and cover are not in this public call; /v1/instagram/user/highlights has them. Highlights that need a login fail at 0 credits. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id (required).
instagram_user_highlightsA
instagram: Story Highlights. GET /v1/instagram/user/highlights. List the story highlights a signed-out visitor sees on a profile: id, title, cropped cover URL and owner. Instagram shows signed-out visitors only some of an account's highlights. cover_media.thumbnail_src is always null; use cover_media_cropped_thumbnail.url. Pass the id to /v1/instagram/user/highlight/detail for the stories. Requires handle: a lookup by user_id needs a login and returns 400. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle, user_id.
instagram_user_postsA
instagram: Posts. GET /v2/instagram/user/posts. Get the first 12 posts on a public profile's grid (reels, photos, videos and carousels): code, URL, media type, caption, display image and date, with the user. Only the first 12 are available signed out: next_max_id is always null and passing one returns 400; more_available says whether the profile has more. Like, comment and play counts are not in the signed-out grid; /v1/instagram/user/reels has counts for reels an Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), trim, next_max_id, require_play_counts.
instagram_user_reelsA
instagram: Reels. GET /v1/instagram/user/reels. Get the first 12 reels on a public profile's reels tab, each with play, like and comment counts, code, URL, cover image and date. Only the first 12 are available signed out: paging_info.max_id is always null and passing max_id returns 400. Captions are not on the reels tab; /v1/instagram/post has them. Requires handle: a lookup by user_id needs a login and returns 400. Post dates (taken_at, taken_at_timestamp, create Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: trim, handle, max_id, user_id, +1 more.
jobs_idA
jobs: Get or poll a job. GET /v1/jobs/{id}. Poll a job created by adding async=true, or the header Prefer: respond-async, to any GET /v1 request. A queued job has not been charged. A finished job's result is the operation body, charged once through the normal ledger. Failed, empty, expired and cancelled jobs cost 0. Costs 0 credits when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id (required).
jobs_id_cancel_postA
jobs: Cancel a job. POST /v1/jobs/{id}/cancel. Cancels a job that is still queued. A running, finished, expired or already cancelled job is unchanged. Cancelling costs 0 credits. Costs 0 credits when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id (required).
kwai_profileA
kwai: Profile. GET /v1/kwai/profile. Provide one of: handle, url. Get public Kwai profile info from a handle or profile URL. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, handle.
kwai_user_postsA
kwai: User Posts. GET /v1/kwai/user/posts. Provide one of: handle, url. Get public posts from a Kwai handle or profile URL. Costs 1 credit when it succeeds. Costs 0 credits when posts is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, count, cursor, handle.
linktreeB
linktree: Linktree page. GET /v1/linktree. Linktree page Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cache_max_age.
mastodon_account_statusesA
mastodon: List an account's statuses. GET /v1/mastodon/account/statuses. Provide one of: acct, id. One page of public statuses. Pass acct, or id together with instance. max_id is the older-than cursor. An empty page costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when statuses is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, acct, max_id, instance, +1 more.
mastodon_hashtagA
mastodon: Hashtag timeline. GET /v1/mastodon/hashtag. One page of the public tag timeline on instance. An empty page costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when statuses is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: hashtag (required), instance (required), max_id, cache_max_age.
mastodon_profileA
mastodon: Look up a fediverse account. GET /v1/mastodon/profile. Looks up acct (user@instance) on that instance's public API. No application token. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: acct (required), cache_max_age.
mastodon_statusB
mastodon: Fetch one status. GET /v1/mastodon/status. One public status by id on instance. HTML is returned as content and as text with tags removed. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id (required), instance (required), cache_max_age.
medium_articleA
medium: Article. GET /v1/medium/article. One article from the author's public feed, including its text. An article that has left the feed is not found. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id (required), username (required), cache_max_age.
medium_user_postsC
medium: User posts. GET /v1/medium/user/posts. Posts in an author's public feed. An empty feed costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when posts is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: username (required), cache_max_age.
pinterest_boardA
pinterest: Board. GET /v1/pinterest/board. Get pins from a Pinterest board. With trim=true, native save counts and keyword labels are retained when available. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, cursor.
pinterest_searchC
pinterest: Search. GET /v1/pinterest/search. Search Pinterest Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), trim, cursor.
pinterest_user_boardsB
pinterest: User Boards. GET /v1/pinterest/user/boards. Get a user's boards Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), trim.
races_eventsA
races: List a race's events. GET /v1/races/events. Lists the distances of a race and the ids /v1/races/results needs. runsignup: pass race_id; every finished event of the race is listed, each with its event_id. athlinks: pass event_id (an edition from /v1/races/search); its courses are listed with course_id. raceroster: pass event_id (a results code or a numeric event id); its races are listed with course_id. An empty list costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when events is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: platform (required), race_id, event_id, cache_max_age.
races_resultsA
races: Result by bib. GET /v1/races/results. One runner's official result, by bib number, in one schema for all three platforms: names, chip and gun time, pace, overall, gender and age-group place, and splits where the platform publishes them. runsignup needs race_id and event_id. athlinks needs event_id and may take course_id (without it the event's courses are tried, largest first). raceroster needs event_id and may take course_id when a bib is used in more t Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: bib (required), event_id (required), platform (required), race_id, +2 more.
races_searchA
races: Find a race. GET /v1/races/search. Searches finished races by name on one timing platform. Each hit carries the ids /v1/races/events and /v1/races/results take: athlinks hits list their recent editions (event_id), runsignup hits give a race_id, raceroster hits give a numeric event_id. An empty list costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when events is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), platform (required), year, cache_max_age.
reddit_postB
reddit: Post. GET /v1/reddit/post. Get information from a Reddit post without comments Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required).
reddit_post_commentsA
reddit: Post Comments. GET /v1/reddit/post/comments. Get Reddit post details and comments. Paginate with one opaque cursor; no cursor batching. For long cursors, use POST with the same JSON-body parameters. Author flair is unavailable. Costs 1 credit when it succeeds. Costs 0 credits when comments is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, cursor.
reddit_post_comments_postA
reddit: Post Comments. POST /v1/reddit/post/comments. Get Reddit post details and comments. Paginate with one opaque cursor; no cursor batching. For long cursors, use POST with the same JSON-body parameters. Author flair is unavailable. Costs 1 credit when it succeeds. Costs 0 credits when comments is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, cursor.
reddit_post_transcriptB
reddit: Post Transcript. GET /v1/reddit/post/transcript. Get the transcript from a Reddit video post Costs 1 credit when it succeeds. Costs 0 credits when transcript is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), language, cache_max_age.
reddit_searchA
reddit: Search. GET /v1/reddit/search. Search Reddit for posts or comments. Anonymous search looks in one subreddit: pass subreddit, or a single-word query, which is also used as the subreddit. sort and timeframe apply where the archive supports them. An empty page costs 0 credits. Search does not return upvote ratios. Use /v1/reddit/post for a post's upvote_ratio. Costs 1 credit when it succeeds. Costs 0 credits when posts is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), sort, trim, after, +3 more.
reddit_subredditB
reddit: Subreddit Posts. GET /v1/reddit/subreddit. Provide one of: subreddit, url. Get recent posts from a subreddit with engagement metrics Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: subreddit (required), sort, trim, after, +2 more.
reddit_subreddit_detailsA
reddit: Subreddit Details. GET /v1/reddit/subreddit/details. Provide one of: subreddit, url. Get details about a subreddit. Pass a subreddit name or URL to the subreddit. Subscriber counts are not available; weekly activity counts are different metrics. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, subreddit, cache_max_age.
reddit_subreddit_searchB
reddit: Subreddit Search. GET /v1/reddit/subreddit/search. Search within a subreddit for posts, comments, or media matching a query Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: subreddit (required), sort, query, cursor, +1 more.
snapchat_profileA
snapchat: User Profile. GET /v1/snapchat/profile. Get a public Snapchat profile (1 credit): name, bio, subscriber count, related accounts and the profile's Spotlight videos with views, shares and comments. Personal accounts return only username, display name and snapcode. Highlights are empty: the public page no longer embeds them. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required).
soundcloud_artistA
soundcloud: Artist. GET /v1/soundcloud/artist. Provide one of: handle, url. Get SoundCloud artist details and follower counts by handle or URL. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, handle.
soundcloud_artist_tracksB
soundcloud: Artist Tracks. GET /v1/soundcloud/artist/tracks. Provide one of: handle, url. Gets tracks/songs for a SoundCloud artist by handle or URL. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, cursor, handle.
soundcloud_trackB
soundcloud: Track. GET /v1/soundcloud/track. Gets detailed information about a SoundCloud track/song by URL. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required).
spotify_albumB
spotify: Album. GET /v1/spotify/album. Provide one of: id, url. Get Spotify album Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
spotify_artistB
spotify: Artist. GET /v1/spotify/artist. Provide one of: id, url. Get Spotify artist Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
spotify_playlistB
spotify: Playlist. GET /v1/spotify/playlist. Provide one of: id, url. Get a Spotify playlist and its tracks Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url, cursor.
spotify_podcastB
spotify: Podcast. GET /v1/spotify/podcast. Provide one of: id, url. Get Spotify podcast Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
spotify_podcast_episodesC
spotify: Podcast Episodes. GET /v1/spotify/podcast/episodes. Provide one of: id, url. Get Spotify podcast episodes Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url, cursor.
spotify_trackB
spotify: Track. GET /v1/spotify/track. Provide one of: id, url. Get Spotify track Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: id, url.
substack_postA
substack: Post. GET /v1/substack/post. One public post by publication and slug. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: slug (required), publication (required), cache_max_age.
substack_postsA
substack: Publication posts. GET /v1/substack/posts. Latest public posts on a publication. Pass a hostname, or a name that lives at name.substack.com. An empty page costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when posts is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: publication (required), cache_max_age.
telegram_channelB
telegram: Channel Details. GET /v1/telegram/channel. Provide one of: handle, url. Get public Telegram channel or group details from its web preview. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cache_max_age.
telegram_channel_postsB
telegram: Channel Posts. GET /v1/telegram/channel/posts. Provide one of: handle, url. Get one page of recent public posts from a Telegram channel or group. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cursor, cache_max_age.
telegram_postA
telegram: Post Details. GET /v1/telegram/post. Get one public Telegram post by URL. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cache_max_age.
tiktok_get_trending_feedB
tiktok: Trending Feed. GET /v1/tiktok/get-trending-feed. Get the trending feed from TikTok. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: region (required), trim.
tiktok_productA
tiktok-shop: Product Details. GET /v1/tiktok/product. Get details for a TikTok Shop product. US products only. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), region.
tiktok_profileB
tiktok: Profile. GET /v1/tiktok/profile. Scrapes a public TikTok profile Costs 1 credit when it succeeds. Costs 1 credit when the outcome is absent. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle, user_id, cache_max_age.
tiktok_profile_videosA
tiktok: Profile Videos. GET /v3/tiktok/profile/videos. Get posts from a TikTok profile, newest first, 15 per page. Follow has_more and max_cursor to page back in time. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), trim, region, sort_by, +3 more.
tiktok_search_hashtagB
tiktok: Search by Hashtag. GET /v1/tiktok/search/hashtag. Search TikTok videos by hashtag. TikTok may return duplicate results. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: hashtag (required), trim, cursor, region.
tiktok_search_keywordA
tiktok: Search by Keyword (keyword pages). GET /v1/tiktok/search/keyword. Get TikTok videos for a phrase from TikTok's public keyword page for it (tiktok.com/discover/), 16 per page, as search_item_list of aweme_info objects (aweme_id, desc, create_time, author, statistics, video, music). The phrase is turned into the page's slug ("how to tie a tie" → how-to-tie-a-tie). Videos only: no accounts, hashtags or sounds. This covers only phrases TikTok has a keyword page for: most multi- Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), trim, cursor, region, +2 more.
tiktok_shop_product_reviewsA
tiktok-shop: Product Reviews. GET /v1/tiktok/shop/product/reviews. Provide one of: url, product_id. The first page of a US TikTok Shop product's reviews (up to 5), with total_reviews and the star breakdown. First page only. A product with no reviews costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when product_reviews is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, page, region, product_id.
tiktok_shop_productsA
tiktok-shop: Shop Products. GET /v1/tiktok/shop/products. A US TikTok Shop store's details (shopInfo) and its first page of products (up to 20) in the store's default order. First page only: cursor is always null, and has_more says whether the store has more. An empty page costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when products is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cursor, region, sort_by.
tiktok_shop_searchA
tiktok-shop: Shop Search. GET /v1/tiktok/shop/search. Products on TikTok Shop's US results page for a keyword (up to about 25). First page only. A keyword with no results page returns 404 at 0 credits, and an empty page costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when products is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), page, region.
tiktok_songB
tiktok: Get Song Details. GET /v1/tiktok/song. Get details for a TikTok sound or song. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: clipId (required).
tiktok_song_videosB
tiktok: TikToks using Song. GET /v1/tiktok/song/videos. Get the TikToks using a song Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: clipId, cursor.
tiktok_user_followersB
tiktok: Followers. GET /v1/tiktok/user/followers. Scrapes followers of a TikTok account Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: trim, handle, user_id, min_time.
tiktok_user_followingA
tiktok: Following. GET /v1/tiktok/user/following. Scrapes accounts that a TikTok user follows Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), trim, min_time.
tiktok_videoA
tiktok: Video Info. GET /v2/tiktok/video. Get a public TikTok video or slideshow by URL. Not-found does not prove deletion. Video files are in video.play_addr and video.bit_rate[].play_addr. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, region, cache_max_age, +2 more.
tiktok_video_comment_repliesA
tiktok: Comment Replies. GET /v1/tiktok/video/comment/replies. Scrapes replies to a TikTok comment Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), comment_id (required), cursor.
tiktok_video_commentsA
tiktok: Comments. GET /v1/tiktok/video/comments. Get comments on public TikTok videos or slideshows. Pages with comments cost 1 credit; empty pages cost 0. An empty page does not prove the post has no comments globally. Costs 1 credit when it succeeds. Costs 0 credits when comments is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, cursor.
tiktok_video_transcriptB
tiktok: Transcript. GET /v1/tiktok/video/transcript. Get a TikTok video's own captions (TikTok's speech recognition or the creator's), as WebVTT and timed segments. No paid transcription. No captions in the language costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when transcript is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), language, cache_max_age.
twitch_clipB
twitch: Clip. GET /v1/twitch/clip. Get Twitch clip details (1 credit). The answer is a bare JSON array with no envelope; the fetchproof-credits-charged and fetchproof-credits-remaining headers carry the credits. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), cache_max_age.
twitch_profileA
twitch: Profile. GET /v1/twitch/profile. Get Twitch profile Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cache_max_age.
twitch_user_clipsB
twitch: Channel clips. GET /v1/twitch/user/clips. One page of a channel's public clips. An empty page costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when clips is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cursor, cache_max_age.
twitch_user_scheduleC
twitch: User Schedule. GET /v1/twitch/user/schedule. Get Twitch user schedule Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required).
twitch_user_videosB
twitch: User Videos. GET /v1/twitch/user/videos. Get Twitch user videos Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), sort_by, filter_by.
twitter_profileB
twitter: Profile. GET /v1/twitter/profile. Get Twitter profile information including stats and metadata Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), cache_max_age.
twitter_tweetB
twitter: Tweet Details. GET /v1/twitter/tweet. Get detailed information about a specific tweet including engagement Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), trim, cache_max_age.
twitter_user_tweetsA
twitter: User Tweets. GET /v1/twitter/user-tweets. Get up to 100 popular tweets from a user's public profile, not their latest tweets. Costs 1 credit when it succeeds. Costs 0 credits when tweets is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle (required), trim.
youtube_channelA
youtube: Channel Details. GET /v1/youtube/channel. Provide one of: channelId, handle, url. Get YouTube channel details and stats by channelId, handle, or URL. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url, handle, channelId, cache_max_age.
youtube_channel_community_postsB
youtube: Channel Community Posts. GET /v1/youtube/channel/community-posts. Provide one of: channelId, handle, continuationToken. Get community posts from a YouTube channel. Can pass channelId or handle. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle, channelId, continuationToken.
youtube_channel_livesA
youtube: Channel Lives. GET /v1/youtube/channel/lives. Provide one of: channelId, handle, continuationToken. Get live streams and past streams from a YouTube channel. Can pass channelId or handle. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle, channelId, continuationToken.
youtube_channel_playlistsA
youtube: Channel Playlists. GET /v1/youtube/channel/playlists. Provide one of: channelId, handle, continuationToken. Get playlists from a YouTube channel. Can pass channelId or handle. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: handle, channelId, continuationToken.
youtube_channel_searchA
youtube: Channel Search. GET /v1/youtube/channel/search. Provide one of: handle, continuationToken. Search within one YouTube channel by keyword. Returns videos, Shorts, live streams and playlists. Costs 1 credit per page, even with no matches. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), handle (required), continuationToken.
youtube_channel_shortsA
youtube: Channel Shorts. GET /v1/youtube/channel/shorts. Provide one of: channelId, handle, continuationToken. Get channel Shorts. publishDate is an ISO 8601 timestamp with an offset when available, otherwise null; date-only values are not returned. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: sort, handle, channelId, continuationToken.
youtube_channel_videosA
youtube: Channel Videos. GET /v1/youtube/channel-videos. Provide one of: channelId, handle. Get paginated videos from a YouTube channel by channelId or handle. Paid-promotion filtering is not supported; use /v1/youtube/video and its isPaidPromotion field for each video's status. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: sort, handle, channelId, includeExtras, +1 more.
youtube_community_postB
youtube: Community Post Details. GET /v1/youtube/community-post. Get the details of a community post Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required).
youtube_playlistA
youtube: Playlist. GET /v1/youtube/playlist. Provide one of: playlist_id, continuationToken. Get a paginated list of videos in a YouTube playlist Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: playlist_id (required), continuationToken.
youtube_searchB
youtube: Search. GET /v1/youtube/search. Search YouTube videos, channels, playlists, Shorts and live streams. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required), type, region, sortBy, +4 more.
youtube_search_hashtagB
youtube: Search by Hashtag. GET /v1/youtube/search/hashtag. Provide one of: hashtag, continuationToken. Search YouTube and get matching videos, channels, and playlists Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: hashtag (required), type, continuationToken.
youtube_search_typeaheadA
youtube: Search Typeahead. GET /v1/youtube/search/typeahead. Get the live autocomplete suggestions shown in YouTube's search dropdown. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: query (required).
youtube_shorts_trendingA
youtube: Trending Shorts. GET /v1/youtube/shorts/trending. Call it with no arguments. Get about 48 trending Shorts per request. Repeated requests can return new Shorts. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: no named parameters.
youtube_videoA
youtube: Video/Short Details. GET /v1/youtube/video. Get YouTube video or Short details, description cards, AI disclosures, owner/uploader identities, paid-promotion status and replay heatmaps. Age-restricted videos return 403. No hosted video downloads. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), language, cache_max_age.
youtube_video_comment_repliesB
youtube: Comment Replies. GET /v1/youtube/video/comment/replies. Get replies to a specific comment on a YouTube video. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: continuationToken (required).
youtube_video_commentsA
youtube: Comments. GET /v1/youtube/video/comments. Provide one of: url, continuationToken. Get comments from a video. Can only get 1k top comments and about 7k new comments. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), order, continuationToken.
youtube_video_sponsorsA
youtube: Video Sponsors. GET /v1/youtube/video/sponsors. Experimental: infer possible video sponsors from public evidence, not an official YouTube sponsor field. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), language.
youtube_video_transcriptA
youtube: Transcript. GET /v1/youtube/video/transcript. Get publicly available captions or a transcript from a YouTube video or Short Costs 1 credit when it succeeds. Costs 0 credits when transcript is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Inputs: url (required), language, cache_max_age, original_audio.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 133 tools
Each tool is prefixed with its source platform (tiktok_, youtube_, instagram_, reddit_, etc.) and targets a distinct resource+action, so cross-platform confusion is rare. The main overlaps are localized: reddit_post_comments (GET) vs reddit_post_comments_post (POST) do the same thing and differ only by HTTP method, and youtube_search / youtube_search_hashtag / youtube_channel_search require careful reading to distinguish. Otherwise boundaries are clean.
The dominant pattern is platform_resource_action in snake_case and it holds for most of the surface. However there are visible deviations: camelCase segments embedded in names (facebook_adLibrary_ad, google_adLibrary_advertisers_search, tiktok_get_trending_feed), path-parameter-derived names (jobs_id, jobs_id_cancel_post), and HTTP-method suffixes (reddit_post_comments_post). Some tiktok-shop tools use the tiktok_ prefix rather than tiktok_shop_, blurring the namespacing.
133 tools is far beyond what an agent can reliably scan and select from in a single flat list, forcing disambiguation-by-name alone. The breadth is somewhat justified by spanning ~20 distinct platforms, but many platforms are represented by only 1-3 tools, so the count reflects aggregation rather than a tightly scoped surface.
Depth platforms (YouTube, Instagram, Facebook, TikTok) have good lifecycle coverage including search, pagination, comments and transcripts, and an account/jobs utility layer exists. But several platforms are thin dead ends: spotify has no search, soundcloud/kwai/bluesky/twitch/linktree/bilibili offer only 1-3 read tools with no search or follower lists, so agents will hit missing-operation walls on many sources.
Maintenance
Related MCP Connectors
Search and read public data from X/Twitter, Reddit, YouTube, Instagram, TikTok, Facebook, Threads, Bluesky, Trustpilot, Amazon, Google Maps, news, forums and the web. 90+ read-only tools plus ready-made research playbooks (lead finding, brand monitoring, review mining). Hosted: connect with an API key; 50 free requests per endpoint each month.
660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.
Live public data from TikTok, LinkedIn, YouTube, X, Reddit and 17 more networks, via one key.
30+ marketing data tools for AI agents: keywords, SERP, backlinks, AI visibility, app store & commerce intelligence, Reddit/LinkedIn/Facebook/YouTube research, web search, page extraction, site audit, image & video generation, one-shot marketing apps. Bring your own API key from supamarketers.com — per-tool pricing in Credits.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI agents to search, describe and call 239 social data endpoints across Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads and Pinterest through a single API key, covering profiles, posts, comments, followers, hashtags, ads and transcripts with one unified schema. Full responses are saved server-side and can be re-sliced for free with jq, fields or size outlines, so agents pull only the data they need into context.121 npmMIT
SocialToAI MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI tools to read publicly visible social media posts, comments, profiles, and trends from 18 platforms such as TikTok, Instagram, X, Reddit, YouTube, Xiaohongshu, and Weibo, on a prepaid pay-per-call basis where failed calls are free. Ships tools for search, trending, detail, comments, user profiles and posts, plus higher-level workflows like brand buzz, comment analysis, account watching, creator discovery, bulk link data, and viral finding.MIT- AlicenseAqualityCmaintenanceExposes a dynamically registered tool for each public social data endpoint, letting MCP clients like Claude, Cursor, and VS Code pull profiles, posts, comments, transcripts, and search results as clean typed JSON from nine platforms. Tool descriptions surface credit costs and returned fields upfront, with failed calls refunded, bounded results, and readable errors that never auto-retry.4267 npm3MIT
- AlicenseAqualityBmaintenanceEnables AI agents to query public social media data across TikTok, Instagram, YouTube, X, Douyin and Xiaohongshu through ten unified business-level tools covering creator and post search, comments, trending topics, and comment insights. Ships one normalized schema over MCP, SSE, REST and stdio, with per-call pricing and cost/balance reported in every response.1038 PyPIMIT