Skip to main content
Glama
Fetchproof MCP Server

Fetchproof MCP Server

@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/mcp

Or install the CLI:

npm install -g @fetchproof/mcp

Claude 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

FETCHPROOF_API_KEY

For tools/call

—

Your key from app.fetchproof.com

FETCHPROOF_BASE_URL

No

https://api.fetchproof.com

API host

FETCHPROOF_TIMEOUT_MS

No

60000

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 mcp

This 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 tools
account_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_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_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_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_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_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_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.

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

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

    B3.2/5.0

    Scored across 133 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      C
      maintenance
      Exposes 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.
      42
      67 npm
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      10
      38 PyPI
      MIT