SocialTap
Social media scraper API. Live data from any public link.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (4)
- HIGH
- INFOen get_profile
- INFOen list_comments
- INFOen search
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"mcp": {
"url": "https://socialtap.dev/mcp"
}
}
}Puntos de conexión remotos
https://socialtap.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (12)
🟢find_endpoint(query, platform, limit)
Find which SocialTap tool and endpoint serves a need ("TikTok comments", "YouTube transcript") or a link: returns the best matches with the tool and arguments to call, the price, the parameters and an example result. Use it when no tool obviously fits, or to check which platforms and links a tool takes. Free, and it works without an API key.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "What you need, in plain words, or a link to a post, video or profile.",
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"platform": {
"description": "Only endpoints on this platform.",
"enum": [
"amazon",
"applemusic",
"bluesky",
"facebook",
"github",
"google",
"hackernews",
"instagram",
"kick",
"komi",
"kwai",
"linkbio",
"linkedin",
"linkme",
"linktree",
"pillar",
"pinterest",
"reddit",
"rumble",
"snapchat",
"soundcloud",
"spotify",
"telegram",
"threads",
"tiktok",
"tiktokshop",
"truthsocial",
"twitch",
"x",
"youtube"
],
"type": "string"
},
"limit": {
"default": 3,
"description": "How many matches to return.",
"maximum": 10,
"minimum": 1,
"type": "integer"
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢get_post(platform, url, country, lang, detail, ...)
Public posts (videos, reels, shorts, photos, carousels, tweets and text) with their author, text, media, and views, likes and comments. Pass url: its link or ID. Price per successful call: 1 credit.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "Optional: a link names its platform. Needed only for a bare ID.",
"enum": [
"applemusic",
"bluesky",
"facebook",
"hackernews",
"instagram",
"kick",
"kwai",
"linkedin",
"pinterest",
"reddit",
"rumble",
"snapchat",
"soundcloud",
"spotify",
"telegram",
"threads",
"tiktok",
"truthsocial",
"twitch",
"x",
"youtube"
],
"type": "string"
},
"url": {
"description": "A link to the item (as shared: a mobile, short or share link works) or its ID.",
"maxLength": 2048,
"type": "string"
},
"country": {
"description": "Only on Apple Music. Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive).",
"type": "string"
},
"lang": {
"description": "Only on Apple Music. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -).",
"type": "string"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}🟢list_posts(platform, handle, tab, since, until, ...)
The posts of a profile, a page per call: public posts (videos, reels, shorts, photos, carousels, tweets and text) with their author, text, media, and views, likes and comments. Pass handle: a profile link, @handle, username or ID. Price per successful page: Bluesky, Facebook, Instagram, Kwai, Reddit, Rumble, Threads, TikTok, Truth Social, X, YouTube: 1 credit. LinkedIn: 1 credit (public page) or 10 credits (data partner). Follow next_cursor while it is set; a short page is not the end.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "Optional with a profile link, which names it; needed with a bare username or ID.",
"enum": [
"bluesky",
"facebook",
"instagram",
"kwai",
"linkedin",
"reddit",
"rumble",
"threads",
"tiktok",
"truthsocial",
"x",
"youtube"
],
"type": "string"
},
"handle": {
"description": "A profile link, @handle, username or ID.",
"maxLength": 2048,
"type": "string"
},
"tab": {
"description": "Only on Bluesky, Rumble or YouTube. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"posts",
"replies",
"media",
"video",
"videos",
"shorts",
"live"
],
"type": "string"
},
"since": {
"description": "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC).",
"type": "string"
},
"until": {
"description": "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC).",
"type": "string"
},
"media": {
"description": "Only on LinkedIn or X. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"image",
"video",
"article",
"any"
],
"type": "string"
},
"sort": {
"description": "Only on Reddit, Rumble, X or YouTube. Order of the results.",
"enum": [
"newest",
"popular",
"relevance",
"controversial",
"oldest"
],
"type": "string"
},
"duration": {
"description": "Only on Rumble. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes); any length when omitted.",
"enum": [
"short",
"long"
],
"type": "string"
},
"limit": {
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"handle"
],
"additionalProperties": false
}🟢get_profile(platform, handle, country, lang, detail, ...)
Public accounts (creators, channels, pages, companies, communities) with their bio, links, and follower and post counts. Pass handle: a profile link, @handle, username or ID. Price per successful call: Apple Music, Bluesky, Facebook, GitHub, Google, Hacker News, Instagram, Komi, Kwai, Lnk.Bio, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X, YouTube: 1 credit. LinkedIn: 1 credit (public page or web search) or 5 credits (data partner).
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "Optional with a profile link, which names it; needed with a bare username or ID.",
"enum": [
"applemusic",
"bluesky",
"facebook",
"github",
"google",
"hackernews",
"instagram",
"komi",
"kwai",
"linkbio",
"linkedin",
"linkme",
"linktree",
"pillar",
"pinterest",
"reddit",
"rumble",
"snapchat",
"soundcloud",
"spotify",
"telegram",
"threads",
"tiktok",
"truthsocial",
"twitch",
"x",
"youtube"
],
"type": "string"
},
"handle": {
"description": "A profile link, @handle, username or ID.",
"maxLength": 2048,
"type": "string"
},
"country": {
"description": "Only on Apple Music or Google. Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive).",
"type": "string"
},
"lang": {
"description": "Only on Apple Music. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -).",
"type": "string"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"handle"
],
"additionalProperties": false
}🟢list_comments(platform, url, sort, since, until, ...)
The comments of a post, a page per call: public comments and replies with their author, text, place in the thread, and like and reply counts. Pass url: its link or ID. Price per successful page: Bluesky, Facebook, Hacker News, Instagram, Reddit, Rumble, Snapchat, Threads, TikTok, X, YouTube: 1 credit. LinkedIn: 1 credit (public page) or 5 credits (data partner). Follow next_cursor while it is set; a short page is not the end.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "Optional: a link names its platform. Needed only for a bare ID.",
"enum": [
"bluesky",
"facebook",
"hackernews",
"instagram",
"linkedin",
"reddit",
"rumble",
"snapchat",
"threads",
"tiktok",
"x",
"youtube"
],
"type": "string"
},
"url": {
"description": "A link to the item (as shared: a mobile, short or share link works) or its ID.",
"maxLength": 2048,
"type": "string"
},
"sort": {
"description": "Only on Bluesky, Facebook, Hacker News, Reddit, Rumble or YouTube. Order of the results.",
"enum": [
"popular",
"newest",
"oldest",
"relevance",
"controversial",
"qa"
],
"type": "string"
},
"since": {
"description": "Only on Bluesky, Facebook, Hacker News, Instagram, Reddit, Rumble, Snapchat, Threads, TikTok, X or YouTube. Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC).",
"type": "string"
},
"until": {
"description": "Only on Bluesky, Facebook, Hacker News, Instagram, Reddit, Rumble, Snapchat, Threads, TikTok, X or YouTube. Only items before this time (exclusive): RFC 3339 or a date (midnight UTC).",
"type": "string"
},
"replies": {
"description": "Only on Reddit. all (default): a walk returns the whole tree, every reply Reddit left behind a \"more replies\" link included (on the pages after the one that shows its parent).",
"enum": [
"all",
"shown"
],
"type": "string"
},
"comment_id": {
"description": "Only on Snapchat. List this comment's replies instead of the Spotlight's comments: the id of a comment from this endpoint.",
"maxLength": 36,
"type": "string"
},
"limit": {
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it).",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}🟢get_transcript(platform, url, lang, detail, max_age, ...)
Timed transcripts of public videos: the platform's caption track, or speech-to-text on the audio when there is none. Pass url: its link or ID. Price per successful call: Facebook, Instagram, LinkedIn, Reddit, Rumble, TikTok, X, YouTube: 1 credit (captions) or 2 credits + 2 per started minute of media (speech-to-text). Kick, Twitch: 2 credits + 2 per started minute of media.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "Optional: a link names its platform. Needed only for a bare ID.",
"enum": [
"facebook",
"instagram",
"kick",
"linkedin",
"reddit",
"rumble",
"tiktok",
"twitch",
"x",
"youtube"
],
"type": "string"
},
"url": {
"description": "A link to the item (as shared: a mobile, short or share link works) or its ID.",
"maxLength": 2048,
"type": "string"
},
"lang": {
"description": "Only on Kick, Reddit, Rumble, TikTok, Twitch, X or YouTube. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -).",
"type": "string"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}🟢get_engagement(platform, handle, tab, detail, max_age, ...)
Engagement rate, average views, likes and comments, posting cadence and top post for an account, computed from its recent posts the same way on every platform. Pass handle: a profile link, @handle, username or ID. Price per successful call: Facebook, Instagram, Reddit, Rumble, TikTok, X, YouTube: 1 credit. LinkedIn: 1 credit (public page) or 15 credits (data partner).
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "Optional with a profile link, which names it; needed with a bare username or ID.",
"enum": [
"facebook",
"instagram",
"linkedin",
"reddit",
"rumble",
"tiktok",
"x",
"youtube"
],
"type": "string"
},
"handle": {
"description": "A profile link, @handle, username or ID.",
"maxLength": 2048,
"type": "string"
},
"tab": {
"description": "Only on Rumble or YouTube. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"videos",
"shorts",
"live"
],
"type": "string"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"handle"
],
"additionalProperties": false
}🟢search(platform, type, query, country, sort, ...)
Search a platform by query for ads, advertisers, albums, channels, comments, communities, events, groups, hashtags, issues, jobs, places, playlists, podcasts, posts, products, profiles, repositories, sounds, suggestions or top. Pass platform, type and query. Types by platform: amazon: products; applemusic: albums, profiles, playlists, posts; bluesky: posts; facebook: ads, advertisers, events, groups, products, places, posts, profiles; github: issues, profiles, repositories; google: ads, profiles, suggestions; hackernews: comments, posts; instagram: hashtags, places, posts, profiles, sounds, suggestions; linkedin: ads, jobs, posts, profiles; pinterest: posts; reddit: comments, posts, profiles, communities; rumble: posts; spotify: albums, profiles, playlists, podcasts, posts; telegram: channels; threads: posts, profiles; tiktok: ads, hashtags, posts, profiles, sounds, suggestions, top; tiktokshop: products; x: communities, hashtags, posts, profiles. Price per successful page: Amazon, Apple Music, Bluesky, GitHub, Google, Hacker News, Instagram, Pinterest, Reddit, Rumble, Spotify, Threads, TikTok Shop: 1 credit. Facebook, LinkedIn, Telegram, TikTok, X: 1 credit + 1 per result filled in. Follow next_cursor while it is set; a short page is not the end.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "The platform to search.",
"enum": [
"amazon",
"applemusic",
"bluesky",
"facebook",
"github",
"google",
"hackernews",
"instagram",
"linkedin",
"pinterest",
"reddit",
"rumble",
"spotify",
"telegram",
"threads",
"tiktok",
"tiktokshop",
"x"
],
"type": "string"
},
"type": {
"description": "What to search for. Each platform searches some types (the tool's description lists them).",
"enum": [
"ads",
"advertisers",
"albums",
"channels",
"comments",
"communities",
"events",
"groups",
"hashtags",
"issues",
"jobs",
"places",
"playlists",
"podcasts",
"posts",
"products",
"profiles",
"repositories",
"sounds",
"suggestions",
"top"
],
"type": "string"
},
"query": {
"description": "The words to search for.",
"maxLength": 1024,
"type": "string"
},
"country": {
"description": "Only on some platforms (find_endpoint lists which). Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive).",
"type": "string"
},
"sort": {
"description": "Only on some platforms (find_endpoint lists which). Order of the results.",
"enum": [
"relevance",
"price_asc",
"price_desc",
"newest",
"popular",
"nearest",
"oldest",
"recent_activity",
"most_comments",
"spend"
],
"type": "string"
},
"lang": {
"description": "Only for Apple Music (every type), Bluesky posts, Facebook ads, Spotify (every type). Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -).",
"type": "string"
},
"kind": {
"description": "Only for Apple Music playlists or posts, GitHub issues, Hacker News posts, Spotify profiles or posts. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"playlist",
"station",
"song",
"music_video",
"radio_episode",
"all",
"issue",
"pull_request",
"story",
"ask_hn",
"show_hn",
"launch_hn",
"job",
"poll",
"artist",
"listener",
"track",
"episode"
],
"type": "string"
},
"author": {
"description": "Only for Bluesky posts, Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 300,
"type": "string"
},
"mentions": {
"description": "Only for Bluesky posts. Only posts that mention this account: a handle, a DID or a profile link.",
"maxLength": 300,
"type": "string"
},
"tag": {
"description": "Only for Bluesky posts. Only posts with this hashtag, with or without the #.",
"maxLength": 100,
"type": "string"
},
"domain": {
"description": "Only for Bluesky posts. Only posts that link to this domain or a subdomain of it.",
"maxLength": 253,
"type": "string"
},
"links_to": {
"description": "Only for Bluesky posts. Only posts that link to this page: a full URL.",
"maxLength": 2000,
"type": "string"
},
"since": {
"description": "Only on some platforms (find_endpoint lists which). Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC).",
"type": "string"
},
"until": {
"description": "Only on some platforms (find_endpoint lists which). Only items before this time (exclusive): RFC 3339 or a date (midnight UTC).",
"type": "string"
},
"status": {
"description": "Only for Facebook ads, GitHub issues, TikTok ads. Only items that are still running (active), only items that stopped (inactive), or both (all).",
"enum": [
"active",
"inactive",
"all"
],
"type": "string"
},
"location": {
"description": "Only for Facebook events or products, LinkedIn jobs. Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 2048,
"type": "string"
},
"fill": {
"description": "Only on some platforms (find_endpoint lists which). true also fetches each result's item from the platform: its full, current record in details (exact counts, its ID), as the platform's own endpoint for that kind returns it.",
"enum": [
"true",
"false"
],
"type": "string"
},
"lat": {
"description": "Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"lng": {
"description": "Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"radius_km": {
"description": "Only for Facebook products. How far around the place to search, in kilometers (default 65).",
"maximum": 805,
"minimum": 1,
"type": "integer"
},
"min_price": {
"description": "Only for Facebook products. Only listings at this price or above, in major units of the local currency.",
"maximum": 2147483647,
"minimum": 0,
"type": "number"
},
"max_price": {
"description": "Only for Facebook products. Only listings at this price or below, in major units of the local currency.",
"maximum": 2147483647,
"minimum": 0,
"type": "number"
},
"period": {
"description": "Only for Facebook products, LinkedIn jobs. The window the ranking counts over, in days back from the platform's latest update (each endpoint lists its own).",
"enum": [
"1",
"7",
"30"
],
"type": "string"
},
"condition": {
"description": "Only for Facebook products. Only listings in these conditions, comma-separated: new, used_like_new, used_good, used_fair.",
"maxLength": 60,
"type": "string"
},
"availability": {
"description": "Only for Facebook products. available (default): listings for sale now.",
"enum": [
"available",
"sold"
],
"type": "string"
},
"delivery_method": {
"description": "Only for Facebook products. all (default), only listings the buyer can pick up (local_pickup), or only those the seller ships (shipping), which can come from far away.",
"enum": [
"all",
"local_pickup",
"shipping"
],
"type": "string"
},
"category_id": {
"description": "Only for Facebook products. Only listings in this Marketplace category (data[].category_id of a listing, such as 1658310421102081 for Bicycles).",
"maxLength": 25,
"type": "string"
},
"media": {
"description": "Only for Facebook posts, Reddit posts. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"video",
"image",
"carousel",
"any"
],
"type": "string"
},
"account_type": {
"description": "Only for Facebook profiles, LinkedIn profiles. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"page",
"person",
"company",
"school",
"showcase",
"member"
],
"type": "string"
},
"topic": {
"description": "Only for Google ads. political: only the election ads that lead to the website (the center's Political ads view), with their impressions and spend; needs country.",
"enum": [
"all",
"political"
],
"type": "string"
},
"format": {
"description": "Only for Google ads. Only ads of this format.",
"enum": [
"text",
"image",
"video"
],
"type": "string"
},
"service": {
"description": "Only for Google ads. Only ads shown on this Google service.",
"enum": [
"google_search",
"google_maps",
"google_play",
"google_shopping",
"youtube"
],
"type": "string"
},
"story": {
"description": "Only for Hacker News comments. Only comments on this story, replies included: a story's link (news.ycombinator.com/item?id=8863) or its item ID.",
"maxLength": 300,
"type": "string"
},
"search_in": {
"description": "Only for Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"all",
"text",
"title",
"url"
],
"type": "string"
},
"min_points": {
"description": "Only for Hacker News posts. Only stories with at least this many points.",
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"min_comments": {
"description": "Only for Hacker News posts. Only stories with at least this many comments.",
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"front_page": {
"description": "Only for Hacker News posts. Only the stories on Hacker News' front page now.",
"type": "boolean"
},
"search_by": {
"description": "Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"keyword",
"advertiser",
"advertiser_id",
"payer"
],
"type": "string"
},
"advertiser": {
"description": "Only for LinkedIn ads. Only ads of advertisers with these words in their name, for a keyword or payer search.",
"maxLength": 200,
"type": "string"
},
"advertiser_id": {
"description": "Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 500,
"type": "string"
},
"countries": {
"description": "Only for LinkedIn ads. Only ads shown in any of these countries: ISO 3166-1 alpha-2 codes with commas.",
"maxLength": 750,
"type": "string"
},
"company_id": {
"description": "Only for LinkedIn jobs. Only jobs at these companies: a company's numeric LinkedIn ID, or several with commas.",
"maxLength": 500,
"type": "string"
},
"easy_apply": {
"description": "Only for LinkedIn jobs. Only jobs applied for on LinkedIn itself (Easy Apply).",
"type": "boolean"
},
"under_10_applicants": {
"description": "Only for LinkedIn jobs. Only jobs with fewer than ten applicants so far.",
"type": "boolean"
},
"subreddit": {
"description": "Only for Reddit comments or posts. Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 256,
"type": "string"
},
"include_body": {
"description": "Only for Reddit posts. Differs by platform: find_endpoint gives each endpoint's.",
"type": "boolean"
},
"tab": {
"description": "Only for Rumble posts. The search tab to list: videos (default; videos and live streams) or shorts.",
"enum": [
"videos",
"shorts"
],
"type": "string"
},
"duration": {
"description": "Only for Rumble posts. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes).",
"enum": [
"short",
"long"
],
"type": "string"
},
"limit": {
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"platform",
"type",
"query"
],
"additionalProperties": false
}🟢call_endpoint(endpoint, arguments)
Call any endpoint by the ID find_endpoint gives (tiktok.sound_posts), with the arguments it gives: the data the other tools here don't cover. Same price, results and cursors as the endpoint's own tool.
Esquema de entrada
{
"type": "object",
"properties": {
"endpoint": {
"description": "The endpoint's ID: <platform>.<name>, from find_endpoint.",
"maxLength": 128,
"minLength": 3,
"type": "string"
},
"arguments": {
"additionalProperties": true,
"description": "Its arguments, as find_endpoint gives them (url, handle or query, its params, detail, cursor); platform and type come from the endpoint.",
"type": "object"
}
},
"required": [
"endpoint"
],
"additionalProperties": false
}🟢search_docs(query, limit)
Search the SocialTap docs (guides, the API reference, error codes, schemas, pricing) for a question or term: returns the best-matching sections with their page, a snippet and the path to read with read_doc. Use it before writing integration code. Free, and it works without an API key.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "What to look up: a question, an error code, a parameter or field name.",
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"limit": {
"default": 5,
"description": "How many sections to return.",
"maximum": 10,
"minimum": 1,
"type": "integer"
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢read_doc(path, cursor)
Read one SocialTap docs page as Markdown: a path from search_docs or llms.txt (/docs/pagination/), or a full docs URL. Long pages come in parts: call again with cursor=next_cursor for the rest. Free, and it works without an API key.
Esquema de entrada
{
"type": "object",
"properties": {
"path": {
"description": "The page: its path on the docs site (/docs/errors/) or its URL, with or without index.md.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"cursor": {
"description": "Where to continue a long page: a previous result's next_cursor.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"path"
],
"additionalProperties": false
}🟢get_account
Get the account, balance and calling key. The account's balance and plan, the low-balance alert threshold, and the calling key: its scopes, spend limit (with what it used this interval) and expiry. Free; never cached. Use it to check the credit balance before a large task; every other result already states credits_remaining.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Comunidad
Evidencia