Social media scraper API. Live data from any public link.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <your SocialTap API key>: needed for every tool but find_endpoint, search_docs and read_doc
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The endpoint's ID: <platform>.<name>, from find_endpoint.
Its arguments, as find_endpoint gives them (url, handle or query, its params, detail, cursor); platform and type come from the endpoint.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://socialtap.dev/mcp
Headers
Authorization (optional, not in the config above): Bearer <your SocialTap API key>: needed for every tool but find_endpoint, search_docs and read_docCall 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.
| Argument | Type | Description |
|---|---|---|
| endpoint* | string | The endpoint's ID: <platform>.<name>, from find_endpoint. |
| arguments | object | 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"
],
"properties": {
"endpoint": {
"type": "string",
"maxLength": 128,
"minLength": 3,
"description": "The endpoint's ID: <platform>.<name>, from find_endpoint."
},
"arguments": {
"type": "object",
"description": "Its arguments, as find_endpoint gives them (url, handle or query, its params, detail, cursor); platform and type come from the endpoint.",
"additionalProperties": true
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many matches to return. |
| query* | string | What you need, in plain words, or a link to a post, video or profile. |
| platform | string | Only endpoints on this platform. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 10,
"minimum": 1,
"description": "How many matches to return."
},
"query": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "What you need, in plain words, or a link to a post, video or profile."
},
"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",
"description": "Only endpoints on this platform."
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| tab | string | Only on Rumble or YouTube. Differs by platform: find_endpoint gives each endpoint's. |
| cursor | string | next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| handle* | string | A profile link, @handle, username or ID. |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| platform | string | Optional with a profile link, which names it; needed with a bare username or ID. |
{
"type": "object",
"required": [
"handle"
],
"properties": {
"tab": {
"enum": [
"videos",
"shorts",
"live"
],
"type": "string",
"description": "Only on Rumble or YouTube. Differs by platform: find_endpoint gives each endpoint's."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"handle": {
"type": "string",
"maxLength": 2048,
"description": "A profile link, @handle, username or ID."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"platform": {
"enum": [
"facebook",
"instagram",
"linkedin",
"reddit",
"rumble",
"tiktok",
"x",
"youtube"
],
"type": "string",
"description": "Optional with a profile link, which names it; needed with a bare username or ID."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | A link to the item (as shared: a mobile, short or share link works) or its ID. |
| lang | string | Only on Apple Music. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -). |
| cursor | string | next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| country | string | Only on Apple Music. Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| platform | string | Optional: a link names its platform. Needed only for a bare ID. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"description": "A link to the item (as shared: a mobile, short or share link works) or its ID."
},
"lang": {
"type": "string",
"description": "Only on Apple Music. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -)."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"country": {
"type": "string",
"description": "Only on Apple Music. Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive)."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"platform": {
"enum": [
"applemusic",
"bluesky",
"facebook",
"hackernews",
"instagram",
"kick",
"kwai",
"linkedin",
"pinterest",
"reddit",
"rumble",
"snapchat",
"soundcloud",
"spotify",
"telegram",
"threads",
"tiktok",
"truthsocial",
"twitch",
"x",
"youtube"
],
"type": "string",
"description": "Optional: a link names its platform. Needed only for a bare ID."
}
},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| lang | string | Only on Apple Music. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -). |
| cursor | string | next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| handle* | string | A profile link, @handle, username or ID. |
| country | string | Only on Apple Music or Google. Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| platform | string | Optional with a profile link, which names it; needed with a bare username or ID. |
{
"type": "object",
"required": [
"handle"
],
"properties": {
"lang": {
"type": "string",
"description": "Only on Apple Music. Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -)."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"handle": {
"type": "string",
"maxLength": 2048,
"description": "A profile link, @handle, username or ID."
},
"country": {
"type": "string",
"description": "Only on Apple Music or Google. Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive)."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"platform": {
"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",
"description": "Optional with a profile link, which names it; needed with a bare username or ID."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | A link to the item (as shared: a mobile, short or share link works) or its ID. |
| lang | string | 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 -). |
| cursor | string | next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| platform | string | Optional: a link names its platform. Needed only for a bare ID. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"description": "A link to the item (as shared: a mobile, short or share link works) or its ID."
},
"lang": {
"type": "string",
"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 -)."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"platform": {
"enum": [
"facebook",
"instagram",
"kick",
"linkedin",
"reddit",
"rumble",
"tiktok",
"twitch",
"x",
"youtube"
],
"type": "string",
"description": "Optional: a link names its platform. Needed only for a bare ID."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | A link to the item (as shared: a mobile, short or share link works) or its ID. |
| sort | string | Only on Bluesky, Facebook, Hacker News, Reddit, Rumble or YouTube. Order of the results. |
| limit | integer | Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). |
| since | string | 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). |
| until | string | 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). |
| cursor | string | next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| replies | string | 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). |
| platform | string | Optional: a link names its platform. Needed only for a bare ID. |
| comment_id | string | Only on Snapchat. List this comment's replies instead of the Spotlight's comments: the id of a comment from this endpoint. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"description": "A link to the item (as shared: a mobile, short or share link works) or its ID."
},
"sort": {
"enum": [
"popular",
"newest",
"oldest",
"relevance",
"controversial",
"qa"
],
"type": "string",
"description": "Only on Bluesky, Facebook, Hacker News, Reddit, Rumble or YouTube. Order of the results."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it)."
},
"since": {
"type": "string",
"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)."
},
"until": {
"type": "string",
"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)."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"replies": {
"enum": [
"all",
"shown"
],
"type": "string",
"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)."
},
"platform": {
"enum": [
"bluesky",
"facebook",
"hackernews",
"instagram",
"linkedin",
"reddit",
"rumble",
"snapchat",
"threads",
"tiktok",
"x",
"youtube"
],
"type": "string",
"description": "Optional: a link names its platform. Needed only for a bare ID."
},
"comment_id": {
"type": "string",
"maxLength": 36,
"description": "Only on Snapchat. List this comment's replies instead of the Spotlight's comments: the id of a comment from this endpoint."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| tab | string | Only on Bluesky, Rumble or YouTube. Differs by platform: find_endpoint gives each endpoint's. |
| sort | string | Only on Reddit, Rumble, X or YouTube. Order of the results. |
| limit | integer | Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). |
| media | string | Only on LinkedIn or X. Differs by platform: find_endpoint gives each endpoint's. |
| since | string | Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). |
| until | string | Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). |
| cursor | string | next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| handle* | string | A profile link, @handle, username or ID. |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| duration | string | Only on Rumble. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes); any length when omitted. |
| platform | string | Optional with a profile link, which names it; needed with a bare username or ID. |
{
"type": "object",
"required": [
"handle"
],
"properties": {
"tab": {
"enum": [
"posts",
"replies",
"media",
"video",
"videos",
"shorts",
"live"
],
"type": "string",
"description": "Only on Bluesky, Rumble or YouTube. Differs by platform: find_endpoint gives each endpoint's."
},
"sort": {
"enum": [
"newest",
"popular",
"relevance",
"controversial",
"oldest"
],
"type": "string",
"description": "Only on Reddit, Rumble, X or YouTube. Order of the results."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it)."
},
"media": {
"enum": [
"image",
"video",
"article",
"any"
],
"type": "string",
"description": "Only on LinkedIn or X. Differs by platform: find_endpoint gives each endpoint's."
},
"since": {
"type": "string",
"description": "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC)."
},
"until": {
"type": "string",
"description": "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC)."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"handle": {
"type": "string",
"maxLength": 2048,
"description": "A profile link, @handle, username or ID."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"duration": {
"enum": [
"short",
"long"
],
"type": "string",
"description": "Only on Rumble. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes); any length when omitted."
},
"platform": {
"enum": [
"bluesky",
"facebook",
"instagram",
"kwai",
"linkedin",
"reddit",
"rumble",
"threads",
"tiktok",
"truthsocial",
"x",
"youtube"
],
"type": "string",
"description": "Optional with a profile link, which names it; needed with a bare username or ID."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| path* | string | The page: its path on the docs site (/docs/errors/) or its URL, with or without index.md. |
| cursor | string | Where to continue a long page: a previous result's next_cursor. |
{
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "The page: its path on the docs site (/docs/errors/) or its URL, with or without index.md."
},
"cursor": {
"type": "string",
"maxLength": 32,
"description": "Where to continue a long page: a previous result's next_cursor."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| lat | number | Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's. |
| lng | number | Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's. |
| tab | string | Only for Rumble posts. The search tab to list: videos (default; videos and live streams) or shorts. |
| tag | string | Only for Bluesky posts. Only posts with this hashtag, with or without the #. |
| fill | string | 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. |
| kind | string | 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. |
| lang | string | 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 -). |
| sort | string | Only on some platforms (find_endpoint lists which). Order of the results. |
| type* | string | What to search for. Each platform searches some types (the tool's description lists them). |
| limit | integer | Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). |
| media | string | Only for Facebook posts, Reddit posts. Differs by platform: find_endpoint gives each endpoint's. |
| query* | string | The words to search for. |
| since | string | 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). |
| story | string | 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. |
| topic | string | 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. |
| until | string | Only on some platforms (find_endpoint lists which). Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). |
| author | string | Only for Bluesky posts, Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's. |
| cursor | string | next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments. |
| detail | string | concise (default) returns the fields that answer most questions; full returns every field. Same price. |
| domain | string | Only for Bluesky posts. Only posts that link to this domain or a subdomain of it. |
| format | string | Only for Google ads. Only ads of this format. |
| period | string | 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). |
| status | string | Only for Facebook ads, GitHub issues, TikTok ads. Only items that are still running (active), only items that stopped (inactive), or both (all). |
| country | string | Only on some platforms (find_endpoint lists which). Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). |
| max_age | integer | Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. |
| service | string | Only for Google ads. Only ads shown on this Google service. |
| duration | string | Only for Rumble posts. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes). |
| links_to | string | Only for Bluesky posts. Only posts that link to this page: a full URL. |
| location | string | Only for Facebook events or products, LinkedIn jobs. Differs by platform: find_endpoint gives each endpoint's. |
| mentions | string | Only for Bluesky posts. Only posts that mention this account: a handle, a DID or a profile link. |
| platform* | string | The platform to search. |
| condition | string | Only for Facebook products. Only listings in these conditions, comma-separated: new, used_like_new, used_good, used_fair. |
| countries | string | Only for LinkedIn ads. Only ads shown in any of these countries: ISO 3166-1 alpha-2 codes with commas. |
| max_price | number | Only for Facebook products. Only listings at this price or below, in major units of the local currency. |
| min_price | number | Only for Facebook products. Only listings at this price or above, in major units of the local currency. |
| radius_km | integer | Only for Facebook products. How far around the place to search, in kilometers (default 65). |
| search_by | string | Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's. |
| search_in | string | Only for Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's. |
| subreddit | string | Only for Reddit comments or posts. Differs by platform: find_endpoint gives each endpoint's. |
| advertiser | string | Only for LinkedIn ads. Only ads of advertisers with these words in their name, for a keyword or payer search. |
| company_id | string | Only for LinkedIn jobs. Only jobs at these companies: a company's numeric LinkedIn ID, or several with commas. |
| easy_apply | boolean | Only for LinkedIn jobs. Only jobs applied for on LinkedIn itself (Easy Apply). |
| front_page | boolean | Only for Hacker News posts. Only the stories on Hacker News' front page now. |
| min_points | integer | Only for Hacker News posts. Only stories with at least this many points. |
| category_id | string | Only for Facebook products. Only listings in this Marketplace category (data[].category_id of a listing, such as 1658310421102081 for Bicycles). |
| account_type | string | Only for Facebook profiles, LinkedIn profiles. Differs by platform: find_endpoint gives each endpoint's. |
| availability | string | Only for Facebook products. available (default): listings for sale now. |
| include_body | boolean | Only for Reddit posts. Differs by platform: find_endpoint gives each endpoint's. |
| min_comments | integer | Only for Hacker News posts. Only stories with at least this many comments. |
| advertiser_id | string | Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's. |
| delivery_method | string | 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. |
| under_10_applicants | boolean | Only for LinkedIn jobs. Only jobs with fewer than ten applicants so far. |
{
"type": "object",
"required": [
"platform",
"type",
"query"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's."
},
"tab": {
"enum": [
"videos",
"shorts"
],
"type": "string",
"description": "Only for Rumble posts. The search tab to list: videos (default; videos and live streams) or shorts."
},
"tag": {
"type": "string",
"maxLength": 100,
"description": "Only for Bluesky posts. Only posts with this hashtag, with or without the #."
},
"fill": {
"enum": [
"true",
"false"
],
"type": "string",
"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."
},
"kind": {
"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",
"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."
},
"lang": {
"type": "string",
"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 -)."
},
"sort": {
"enum": [
"relevance",
"price_asc",
"price_desc",
"newest",
"popular",
"nearest",
"oldest",
"recent_activity",
"most_comments",
"spend"
],
"type": "string",
"description": "Only on some platforms (find_endpoint lists which). Order of the results."
},
"type": {
"enum": [
"ads",
"advertisers",
"albums",
"channels",
"comments",
"communities",
"events",
"groups",
"hashtags",
"issues",
"jobs",
"places",
"playlists",
"podcasts",
"posts",
"products",
"profiles",
"repositories",
"sounds",
"suggestions",
"top"
],
"type": "string",
"description": "What to search for. Each platform searches some types (the tool's description lists them)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it)."
},
"media": {
"enum": [
"video",
"image",
"carousel",
"any"
],
"type": "string",
"description": "Only for Facebook posts, Reddit posts. Differs by platform: find_endpoint gives each endpoint's."
},
"query": {
"type": "string",
"maxLength": 1024,
"description": "The words to search for."
},
"since": {
"type": "string",
"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)."
},
"story": {
"type": "string",
"maxLength": 300,
"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."
},
"topic": {
"enum": [
"all",
"political"
],
"type": "string",
"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."
},
"until": {
"type": "string",
"description": "Only on some platforms (find_endpoint lists which). Only items before this time (exclusive): RFC 3339 or a date (midnight UTC)."
},
"author": {
"type": "string",
"maxLength": 300,
"description": "Only for Bluesky posts, Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's."
},
"cursor": {
"type": "string",
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments."
},
"detail": {
"enum": [
"concise",
"full"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price."
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "Only for Bluesky posts. Only posts that link to this domain or a subdomain of it."
},
"format": {
"enum": [
"text",
"image",
"video"
],
"type": "string",
"description": "Only for Google ads. Only ads of this format."
},
"period": {
"enum": [
"1",
"7",
"30"
],
"type": "string",
"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)."
},
"status": {
"enum": [
"active",
"inactive",
"all"
],
"type": "string",
"description": "Only for Facebook ads, GitHub issues, TikTok ads. Only items that are still running (active), only items that stopped (inactive), or both (all)."
},
"country": {
"type": "string",
"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)."
},
"max_age": {
"type": "integer",
"minimum": 0,
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh."
},
"service": {
"enum": [
"google_search",
"google_maps",
"google_play",
"google_shopping",
"youtube"
],
"type": "string",
"description": "Only for Google ads. Only ads shown on this Google service."
},
"duration": {
"enum": [
"short",
"long"
],
"type": "string",
"description": "Only for Rumble posts. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes)."
},
"links_to": {
"type": "string",
"maxLength": 2000,
"description": "Only for Bluesky posts. Only posts that link to this page: a full URL."
},
"location": {
"type": "string",
"maxLength": 2048,
"description": "Only for Facebook events or products, LinkedIn jobs. Differs by platform: find_endpoint gives each endpoint's."
},
"mentions": {
"type": "string",
"maxLength": 300,
"description": "Only for Bluesky posts. Only posts that mention this account: a handle, a DID or a profile link."
},
"platform": {
"enum": [
"amazon",
"applemusic",
"bluesky",
"facebook",
"github",
"google",
"hackernews",
"instagram",
"linkedin",
"pinterest",
"reddit",
"rumble",
"spotify",
"telegram",
"threads",
"tiktok",
"tiktokshop",
"x"
],
"type": "string",
"description": "The platform to search."
},
"condition": {
"type": "string",
"maxLength": 60,
"description": "Only for Facebook products. Only listings in these conditions, comma-separated: new, used_like_new, used_good, used_fair."
},
"countries": {
"type": "string",
"maxLength": 750,
"description": "Only for LinkedIn ads. Only ads shown in any of these countries: ISO 3166-1 alpha-2 codes with commas."
},
"max_price": {
"type": "number",
"maximum": 2147483647,
"minimum": 0,
"description": "Only for Facebook products. Only listings at this price or below, in major units of the local currency."
},
"min_price": {
"type": "number",
"maximum": 2147483647,
"minimum": 0,
"description": "Only for Facebook products. Only listings at this price or above, in major units of the local currency."
},
"radius_km": {
"type": "integer",
"maximum": 805,
"minimum": 1,
"description": "Only for Facebook products. How far around the place to search, in kilometers (default 65)."
},
"search_by": {
"enum": [
"keyword",
"advertiser",
"advertiser_id",
"payer"
],
"type": "string",
"description": "Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's."
},
"search_in": {
"enum": [
"all",
"text",
"title",
"url"
],
"type": "string",
"description": "Only for Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's."
},
"subreddit": {
"type": "string",
"maxLength": 256,
"description": "Only for Reddit comments or posts. Differs by platform: find_endpoint gives each endpoint's."
},
"advertiser": {
"type": "string",
"maxLength": 200,
"description": "Only for LinkedIn ads. Only ads of advertisers with these words in their name, for a keyword or payer search."
},
"company_id": {
"type": "string",
"maxLength": 500,
"description": "Only for LinkedIn jobs. Only jobs at these companies: a company's numeric LinkedIn ID, or several with commas."
},
"easy_apply": {
"type": "boolean",
"description": "Only for LinkedIn jobs. Only jobs applied for on LinkedIn itself (Easy Apply)."
},
"front_page": {
"type": "boolean",
"description": "Only for Hacker News posts. Only the stories on Hacker News' front page now."
},
"min_points": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Only for Hacker News posts. Only stories with at least this many points."
},
"category_id": {
"type": "string",
"maxLength": 25,
"description": "Only for Facebook products. Only listings in this Marketplace category (data[].category_id of a listing, such as 1658310421102081 for Bicycles)."
},
"account_type": {
"enum": [
"page",
"person",
"company",
"school",
"showcase",
"member"
],
"type": "string",
"description": "Only for Facebook profiles, LinkedIn profiles. Differs by platform: find_endpoint gives each endpoint's."
},
"availability": {
"enum": [
"available",
"sold"
],
"type": "string",
"description": "Only for Facebook products. available (default): listings for sale now."
},
"include_body": {
"type": "boolean",
"description": "Only for Reddit posts. Differs by platform: find_endpoint gives each endpoint's."
},
"min_comments": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Only for Hacker News posts. Only stories with at least this many comments."
},
"advertiser_id": {
"type": "string",
"maxLength": 500,
"description": "Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's."
},
"delivery_method": {
"enum": [
"all",
"local_pickup",
"shipping"
],
"type": "string",
"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."
},
"under_10_applicants": {
"type": "boolean",
"description": "Only for LinkedIn jobs. Only jobs with fewer than ten applicants so far."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many sections to return. |
| query* | string | What to look up: a question, an error code, a parameter or field name. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1,
"description": "How many sections to return."
},
"query": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "What to look up: a question, an error code, a parameter or field name."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.