Social Fetch
io.github.social-freak-ltd/socialfetchPublic social-data API and live docs for AI coding agents.
Tools · 208
Get a TikTok profile by handle. Returns lookupStatus plus profile metrics (followers, posts/videoCount, privateAccount, accountCreatedAt).
List videos from a TikTok profile by handle. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
List followers of a TikTok profile by handle. Returns a list (use cursor when paginated).
List accounts followed by a TikTok profile by handle. Returns a list (use cursor when paginated).
Get the region code reported for a TikTok profile by handle.
Get audience location demographics for a TikTok profile by handle.
Check whether a TikTok creator is currently live by handle.
Get TikTok profile engagement audit. Accepts a handle.
Search TikTok users by keyword. Discover real handles before profile gets; avoid inventing usernames.
Search TikTok videos by free-text keyword (not hashtag — use tiktok.search.hashtag.list for that). Returns a list (use cursor when paginated).
Search TikTok Top results by keyword (not videos-only — use tiktok.search.videos.list for that). Returns a list (use cursor when paginated).
Search TikTok videos by hashtag (not free-text keyword — use tiktok.search.videos.list for that). Returns a list (use cursor when paginated).
Get TikTok search suggestions by query. Returns a list (use cursor when paginated).
Get a single TikTok video by URL. Author is identity-only (no follower counts) — use tiktok_profile_get for metrics. Credits: 1 (+downloadMedia add-on).
List comments on a TikTok video by URL. Returns a list (use cursor when paginated).
List replies to a TikTok video comment. Accepts a comment id. Returns a list (use cursor when paginated).
Download TikTok video or photo post media. Accepts a video URL.
Get the spoken transcript for a TikTok video by URL.
List currently trending TikTok posts for a region. Returns a list (use cursor when paginated).
List videos in a public TikTok collection by URL. Returns a list (use cursor when paginated).
Get details for a TikTok song or sound by id.
List TikTok videos that use a specific music clip. Accepts a clip id. Returns a list (use cursor when paginated).
Search products in TikTok Shop by keyword. Returns a list (use cursor when paginated).
List products in a TikTok Shop store by shop id or URL. Returns a list (use cursor when paginated).
Get details for a TikTok Shop product by product id. Accepts a product page URL.
List buyer reviews for a TikTok Shop product by product id. Returns a list (use cursor when paginated).
List products featured on a creator's TikTok showcase by handle. Returns a list (use cursor when paginated).
Get a single TikTok Ad Library or Top Ads creative by ad id or public ad URL.
Search TikTok Top Ads by keyword and filters, or search the public Ads Library by advertiser name. Returns a list (use cursor when paginated).
Get an X (Twitter) profile by handle. Returns lookupStatus plus follower/tweet metrics and account age signals.
List tweets from an X profile by handle. Returns a list (use cursor when paginated).
Get a single tweet by URL. Author includes profile metrics when not trimmed. Warning: trim=true omits author. Credits: 1.
List replies to a tweet by URL. Returns a list (use cursor when paginated).
Get the transcript for a video tweet by URL.
Search X posts by free-text keyword (not hashtag — use twitter.hashtag.list for that). Returns a list (use cursor when paginated).
Search X posts by hashtag (not free-text keyword — use twitter.search.list for that). Returns a list (use cursor when paginated).
Get details for an X community by community id or URL.
List tweets from an X community by community id or URL. Returns a list (use cursor when paginated).
Get metadata for a public Telegram channel or group by username.
List recent posts from a public Telegram channel. Groups are not supported. Accepts a handle. Returns a list (use cursor when paginated).
Get a single public post from a Telegram channel by handle and post ID. Groups are not supported.
Get a creator Amazon Shop storefront by URL.
Get a public Linktree profile by handle, including links and socials.
Search Hacker News by keyword. Returns a list (use page/pageSize when paginated).
List a Hacker News feed by type (top, new, best, ask, show, or jobs). Accepts a feed name. Returns a list (use page/pageSize when paginated).
Get a Hacker News story by id.
List comments on a Hacker News story by id. Returns a list (use cursor when paginated).
Get a Hacker News item by id.
Get a Hacker News comment with its ancestor chain to the root story. Accepts a comment id.
Get a Hacker News user profile by username.
List a Hacker News user's stories, polls, and jobs (newest first). Accepts a username. Returns a list (use page/pageSize when paginated).
List a Hacker News user's comments (newest first). Accepts a username. Returns a list (use page/pageSize when paginated).
List favorites for a Hacker News user by username. Returns a list (use page when paginated; 1-based).
List top-level jobs from the monthly Hacker News Who is Hiring thread (latest thread, or a YYYY-MM month). Returns a list (use page/pageSize when paginated).
Get recently changed Hacker News item ids and usernames.
Get the current largest Hacker News item id.
Get a Truth Social profile by handle or account id.
List posts from a Truth Social profile by handle or account id. Returns a list (use cursor when paginated).
Get a Truth Social post by URL.
Get a Facebook profile or Page by URL or username.
List posts from a Facebook profile or Page. Accepts a profile URL or page id. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
List Reels from a Facebook profile or Page. Accepts a profile or page URL. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
List photos from a Facebook profile or Page. Accepts a profile or page URL. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
List events hosted by a Facebook profile or Page. Accepts a profile or page URL. Returns a list (use cursor when paginated).
Get a Facebook post or Reel by URL.
List comments on a Facebook post or Reel by URL. Returns a list (use cursor when paginated).
List replies to a Facebook comment. Accepts a from post comments. Returns a list (use cursor when paginated).
Get the transcript for a Facebook post or Reel by URL.
Get a Facebook group by URL or group id.
List posts from a Facebook group by group URL. Returns a list (use cursor when paginated).
Search Facebook Marketplace locations to obtain coordinates for listing search. Accepts a city or place name. Returns a list (use cursor when paginated).
Search Facebook Marketplace listings by keyword near a latitude and longitude. Returns a list (use cursor when paginated).
Get details for a Facebook Marketplace listing by item URL.
Search Facebook events by name. Returns a list (use cursor when paginated).
List Facebook events for a city by explore URL. Returns a list (use cursor when paginated).
Get a Facebook event by URL or event id.
Get a single Facebook Ad Library ad by archive id or public Ad Library URL.
Search Facebook Ad Library ads by keyword and filters. Returns a list (use cursor when paginated).
List ads a company or Page is running in the Facebook Ad Library. Accepts a page id or company name. Returns a list (use cursor when paginated).
Search Facebook Ad Library companies / advertisers by name. Accepts a company name. Returns a list (use cursor when paginated).
List ads a company or advertiser is running in Google Ad Transparency. Accepts a domain or advertiser id. Returns a list (use cursor when paginated).
Get a single Google Ad Transparency creative by public Ad Transparency URL.
Search Google Ad Transparency advertisers by name. Accepts a advertiser name. Returns a list (use cursor when paginated).
Get a full Instagram profile by handle (bio, counts, and related fields). Returns lookupStatus plus follower/post metrics and privacy flags.
Get a lightweight Instagram profile by numeric user ID when you already have the id.
List posts from an Instagram profile by handle. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
List Reels from one specific Instagram profile by handle (not a keyword search — use instagram.search.reels.list for that; not trending — use instagram.reels.trending.list for that). Credits: 1 base; …
List story highlight albums for an Instagram profile by handle. Returns a list (use cursor when paginated).
List Instagram posts a user is tagged in, by user id. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
Get stories inside a saved Instagram highlight by highlight id.
Get Instagram profile engagement audit. Accepts a handle.
Search Instagram accounts, hashtags, and places by keyword (not posts — use instagram.search.popular.list; not profile discovery — use instagram.search.profiles.list). Returns a list (use cursor when …
Search Instagram profiles by keyword. Returns a list (use cursor when paginated).
Search Reels site-wide by keyword (not scoped to one profile — use instagram.profile.reels.list; not trending — use instagram.reels.trending.list; not audio-page — use instagram.audio.reels.list). Ret…
Search public Instagram posts and Reels by hashtag. Returns a list (use cursor when paginated).
Search Instagram's curated Popular topics by keyword. Returns a list (use cursor when paginated).
Get a single Instagram post or Reel by URL. Author is under owner (not author); timestamps use createdAt (ISO; legacy Unix takenAt may still appear at runtime).
List comments on an Instagram post or Reel by URL. Returns a list (use cursor when paginated).
List replies to a comment on an Instagram post or Reel. Accepts a comment id and post URL. Returns a list (use cursor when paginated).
Download Instagram post or reel media. Accepts a post URL.
Get the spoken transcript for an Instagram post or Reel by URL.
List currently trending Instagram Reels (not a keyword search, profile-scoped, or audio-page list — use instagram.search.reels.list, instagram.profile.reels.list, or instagram.audio.reels.list for tha…
List Instagram Reels that use a specific audio track, with track metadata, tagged users, and coauthors when Instagram exposes them. Accepts a audio id. Returns a list (use cursor when paginated).
List public boards for a Pinterest profile. Accepts a handle. Returns a list (use cursor when paginated).
List public pins on a Pinterest board by URL. Returns a list (use cursor when paginated).
Fetch a public Pinterest pin by URL.
Search public Pinterest pins by keyword. Returns a list (use cursor when paginated).
Get a Threads profile for a creator or account. Accepts a handle.
List posts from a Threads profile by handle. Returns a list (use cursor when paginated).
Get a single Threads post by URL.
Search Threads posts by keyword. Returns a list (use cursor when paginated).
Search Threads users by keyword. Returns a list (use cursor when paginated).
Get a Bluesky profile for a creator or account. Accepts a handle.
List posts from a Bluesky profile by handle. Returns a list (use cursor when paginated).
Get a single Bluesky post by URL.
Get LinkedIn person profiles by URL or handle. Returns a list (use cursor when paginated).
List posts from one specific LinkedIn person profile by URL (not a keyword search — use linkedin.posts.search.list to search across public posts). Returns a list (use cursor when paginated).
Look up LinkedIn company, school, or organization pages by URL (broader than linkedin.company.get). Returns a list (use cursor when paginated).
Get a LinkedIn company page by company URL — use linkedin.organization.get for schools and mixed organization URLs.
List posts from one specific LinkedIn company page by URL (not a keyword search — use linkedin.posts.search.list to search across public posts). Returns a list (use cursor when paginated).
Get a LinkedIn post or article by URL.
Get the transcript for a LinkedIn post video by URL.
Search LinkedIn people by first and/or last name. Returns a list (use cursor when paginated).
Search public LinkedIn posts site-wide by keyword (not scoped to one profile or company — use linkedin.profiles.posts.list or linkedin.company.posts.list for that). Returns a list (use cursor when pag…
Get a LinkedIn Ad Library ad by ad id or Ad Library URL.
Search LinkedIn Ad Library ads by company, keyword, or company id. Returns a list (use cursor when paginated).
Get LinkedIn job postings by job URL. Returns a list (use cursor when paginated).
Search LinkedIn jobs by keyword and filters. Returns a list (use cursor when paginated).
Get details for a Reddit community (subreddit).
List a subreddit's post feed (hot/new/top, no keyword) — use reddit.subreddit.search.list to search within it by keyword. Returns a list (use cursor when paginated).
Get a Reddit post by URL.
List comments on a Reddit post by URL. Returns a list (use cursor when paginated).
Get captions transcript for a Reddit video post. Accepts a post or video URL.
Search posts within one subreddit (not site-wide — use reddit.search.list for that). Accepts a subreddit and query. Returns a list (use cursor when paginated).
Search Reddit posts site-wide by keyword (not scoped to one subreddit — use reddit.subreddit.search.list for that). Returns a list (use cursor when paginated).
List videos and Shorts from a Rumble channel. Accepts a channel URL. Returns a list (use cursor when paginated).
Search Rumble for videos and Shorts by keyword. Returns a list (use cursor when paginated).
Get metadata for a Rumble video by URL.
Get captions for a Rumble video when available. Accepts a video URL.
List top-level comments on a Rumble video. Accepts a video URL. Returns a list (use cursor when paginated).
Get a Twitch profile for a channel by handle.
List videos from a Twitch channel by handle. Returns a list (use cursor when paginated).
Get the stream schedule for a Twitch channel by handle.
Get metadata and playback URLs for a Twitch clip by URL.
Get a GitHub profile for a user or organization. Accepts a username.
List repositories for a GitHub user or organization. Accepts a username. Returns a list (use cursor when paginated).
List pull requests authored by a GitHub user. Accepts a username. Returns a list (use cursor when paginated).
List recent public activity for a GitHub profile, one month per request. Accepts a username. Returns a list (use cursor when paginated).
List followers for a GitHub profile. Accepts a username. Returns a list (use cursor when paginated).
List accounts a GitHub profile follows. Accepts a username. Returns a list (use cursor when paginated).
Get the contribution graph for a GitHub profile for a given year. Accepts a username.
Get a single GitHub repository by URL.
List trending GitHub repositories for a language and time window. Returns a list (use cursor when paginated).
List trending GitHub developers for a language and time window. Returns a list (use cursor when paginated).
Get a Spotify artist by id or profile URL.
Get a Spotify album by id or album URL.
Get a Spotify track by id or track URL.
Search the Apple Music catalog by keyword. Returns a list (use cursor when paginated).
Get an Apple Music artist by id or artist URL.
Get an Apple Music album by id or album URL.
Get an Apple Music track by id or track URL.
Get a SoundCloud profile by handle.
List a SoundCloud profile's tracks, newest first. Accepts a handle. Returns a list (use cursor when paginated).
Get a SoundCloud track by URL.
Get YouTube channel details by channel id, handle, or URL. Returns channel metrics and identifiers for snapshot baselines.
List long-form videos from a YouTube channel (not Shorts — use youtube.channel.shorts.list). Accepts a channel id or handle. Returns a list (use cursor when paginated).
List Shorts from a YouTube channel (not long-form videos). Accepts a channel id or handle. Returns a list (use cursor when paginated).
Get a YouTube playlist by playlist id.
Get a YouTube community post by URL.
Search YouTube videos, channels, and playlists by free-text keyword (not hashtag — use youtube.search.hashtag.list for that). Returns a list (use cursor when paginated).
Search YouTube content by hashtag (not free-text keyword — use youtube.search.list for that). Returns a list (use cursor when paginated).
Get a single YouTube video by URL. Channel lives under channel (not author); publish time is publishedAt.
List comments on a YouTube video by URL. Returns a list (use cursor when paginated).
Analyze YouTube video comments. Accepts a video URL.
List replies to a YouTube comment. Accepts a from video comments. Returns a list (use cursor when paginated).
Get the transcript for a YouTube video by URL.
List currently trending YouTube Shorts. Returns a list (use cursor when paginated).
Search the public web and return ranked organic results with snippets. Accepts a query. Returns a list (use cursor when paginated).
Convert a web page URL into clean markdown.
Ask a natural-language question about a specific web page and get an LLM-generated answer. Accepts a URL.
Fetch cleaned HTML for a web page URL.
Capture a screenshot of a public web page URL as a hosted image artifact.
Crawl a small set of web pages synchronously. Accepts a URLs. Returns a list (use cursor when paginated).
Extract structured fields from a web page using a CSS selector schema. Accepts a URL and CSS schema.
Route a natural-language social-data question to the right lookup when you do not yet know the typed tool — prefer typed tools once the operation is known. Accepts a natural-language query.
Get the authenticated API account for this session.
Get remaining credit balance before running large batches of metered tools.
Search SocialFetch docs for API/SDK questions. For response fields use docs_read (defaults to outline). For cross-platform author/timestamp naming, search `field crosswalk` or read /product/ask-ai/fie…
Read a corpus page by docsPathname from docs_search. Defaults to mode=outline (compact field digest). Pass mode=full for Examples/SDK snippets. Accepts /docs/... and /product/... pathnames (including …
List every public API operation Monitors can watch (Twitter/X, Instagram, TikTok, Reddit profiles and searches). Powers the monitor-creation flow.
Watch a social account or search and get a signed webhook when new content appears. Runs a synchronous baseline check on create — the response includes what's there right now, and you'll only get webh…
List the caller's monitors, optionally filtered by status.
Get one monitor by id.
Update a monitor's name, schedule, webhook endpoint, spend cap, or status (pause/resume).
Permanently delete a monitor. Cannot be undone.
Queue an immediate check for an active monitor (async — returns once queued, not once the check finishes).
Pull API for a monitor's events — queryable regardless of webhook delivery configuration.
The self-serve "why didn't I get a webhook" view — the last ~50 checks with outcome/credits/reason.
Create a delivery target for monitor events. kind=http requires a public HTTPS url; kind=sink is a hosted test inbox with no url. The signing secret is returned once — store it now.
List the caller's webhook endpoints (secret material never included).
Get one webhook endpoint by id (secret material never included).
Update a webhook endpoint's description or enable/disable it.
Permanently delete a webhook endpoint. Cannot be undone.
Send a realistic per-source sample event to a webhook endpoint right now — a live, synchronous delivery test.
Rotate the signing secret with a 24h overlap window — the old secret keeps working until it expires. The new secret is returned once.
List delivery attempts for a webhook endpoint. Supports `limit`, opaque `cursor` continuation, and optional `after` (ISO timestamp) to enter oldest-first tail mode for listeners.
Queue a manual redelivery for one delivery attempt (async).
Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.
Resources · 4
Public profile, channel, company, or creator identity card
ui://socialfetch/v1/profile-card.html
Single public post, video, repository, job, or other item
ui://socialfetch/v1/item-card.html
List card for public search and feed results
ui://socialfetch/v1/search-list.html
Readable transcript card for public video or audio
ui://socialfetch/v1/transcript.html
Similar MCP servers embedding-nearest
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"social_fetch": {
"url": "https://api.socialfetch.dev/mcp",
"transport": "streamable-http"
}
}
}