# Social Fetch (remote · api.socialfetch.dev)

Public social-data API and live docs for AI coding agents.

- Trust score: 69/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.socialfetch.dev`: 69/100 (this document), [markdown](https://verifymcp.io/servers/social-freak-ltd-socialfetch/api.md), [page](https://verifymcp.io/servers/social-freak-ltd-socialfetch/api)

## Channel facts

- Endpoint: `https://api.socialfetch.dev/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.13.5`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 186 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 15085 tokens (~81/item across 186 items; 186 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 93% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http social-freak-ltd-socialfetch https://api.socialfetch.dev/mcp
```

### Codex

```toml
[mcp_servers.social-freak-ltd-socialfetch]
url = "https://api.socialfetch.dev/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "social-freak-ltd-socialfetch": {
      "type": "remote",
      "url": "https://api.socialfetch.dev/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add social-freak-ltd-socialfetch --url https://api.socialfetch.dev/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  social-freak-ltd-socialfetch:
    url: "https://api.socialfetch.dev/mcp"
```

### Other

```json
{
  "mcpServers": {
    "social-freak-ltd-socialfetch": {
      "type": "http",
      "url": "https://api.socialfetch.dev/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 69, +1)

- [functional] Server version: 0.23.0 → 0.24.0
- [functional] New tool “instagram_post_comments_replies_list”

### 2026-07-31 (score 68, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 67, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 66, −1)

- [functional] Schema quality: excellent → good
- [functional] Server version: 0.20.0 → 0.21.0
- [functional] New tool “soundcloud_profile_get”
- [functional] New tool “soundcloud_profile_tracks_list”
- [functional] New tool “soundcloud_track_get”
- [cosmetic] “facebook_profile_posts_list” reworded the description of “cursor”
- [cosmetic] “facebook_profile_reels_list” reworded the description of “cursor”
- [cosmetic] “google_company_ads_list” reworded the description of “cursor”
- [cosmetic] “hackernews_search_list” reworded the description of “pageSize”
- [cosmetic] “instagram_profile_posts_list” reworded the description of “cursor”
- [cosmetic] “instagram_profile_reels_list” reworded the description of “cursor”
- [cosmetic] “linkedin_jobs_search_list” reworded the description of “country”
- [cosmetic] “linkedin_jobs_search_list” reworded the description of “location”
- [cosmetic] “linkedin_profiles_posts_list” reworded the description of “endDate”
- [cosmetic] “linkedin_profiles_posts_list” reworded the description of “startDate”
- [cosmetic] “reddit_subreddit_posts_list” reworded the description of “cursor”
- [cosmetic] “linkedin_jobs_search_list” reworded the description of “keyword”
- [cosmetic] “facebook_company_ads_list” reworded the description of “cursor”
- [cosmetic] “facebook_group_posts_list” reworded the description of “cursor”
- [cosmetic] “facebook_profile_photos_list” reworded the description of “cursor”

### 2026-07-28 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 66, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 66)

First indexed and scored.

## MCP tools (186)

### `tiktok_profile_get` (~58 tokens)

Get TikTok profile

Get a TikTok profile by handle. Returns lookupStatus plus profile metrics (followers, posts/videoCount, privateAccount, accountCreatedAt).

Input parameters:

- `handle` (string, required): TikTok handle to look up, with or without a leading @.

### `tiktok_profile_engagement_get` (~44 tokens)

Get TikTok profile engagement audit

Get TikTok profile engagement audit. Accepts a handle.

Input parameters:

- `handle` (string, required): TikTok handle to look up, with or without a leading @.

### `tiktok_profile_videos_list` (~131 tokens)

List TikTok profile videos

List videos from a TikTok profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `handle` (string, required): TikTok handle whose videos should be listed.
- `region` (string): Optional ISO 3166-1 country code for the request.
- `sortBy` (string): Optional sort order for the returned TikTok videos.
- `trim` (boolean): Optional flag for a smaller response with fewer fields.
- `userId` (string): Optional TikTok user id to speed up the request.

### `tiktok_profile_followers_list` (~93 tokens)

List TikTok profile followers

List followers of a TikTok profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `handle` (string, required): TikTok handle whose followers should be listed.
- `trim`: Optional flag for a smaller response with fewer fields.
- `userId` (string): Optional TikTok user id to speed up the request.

### `tiktok_profile_following_list` (~79 tokens)

List TikTok profile following

List accounts followed by a TikTok profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `handle` (string, required): TikTok handle whose following list should be listed.
- `trim` (boolean): Optional flag for a smaller response with fewer fields.

### `tiktok_profile_region_get` (~44 tokens)

Get TikTok profile region

Get the region code reported for a TikTok profile by handle.

Input parameters:

- `handle` (string, required): TikTok handle to look up, with or without a leading @.

### `tiktok_profile_audience_get` (~44 tokens)

Get TikTok profile audience

Get audience location demographics for a TikTok profile by handle.

Input parameters:

- `handle` (string, required): TikTok handle to look up, with or without a leading @.

### `tiktok_profile_live_check` (~43 tokens)

Get TikTok live stream

Check whether a TikTok creator is currently live by handle.

Input parameters:

- `handle` (string, required): TikTok handle to look up, with or without a leading @.

### `tiktok_users_search` (~59 tokens)

Search TikTok users

Search TikTok users by keyword. Discover real handles before profile gets; avoid inventing usernames.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `query` (string, required): Search query text for TikTok users.

### `tiktok_search_videos_list` (~142 tokens)

Search TikTok videos

Search TikTok videos by free-text keyword (not hashtag — use tiktok.search.hashtag.list for that). Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `datePosted` (string): Optional upload date filter for video results.
- `query` (string, required): Search query text for TikTok videos.
- `region` (string): Optional two-letter ISO 3166-1 country code for localized search results.
- `sortBy` (string): Optional sort order for search results.
- `trim` (boolean): When true, returns a smaller response with fewer fields.

### `tiktok_search_hashtag_list` (~126 tokens)

Search TikTok by hashtag

Search TikTok videos by hashtag (not free-text keyword — use tiktok.search.videos.list for that). Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `hashtag` (string, required): Hashtag to search for. A leading # is optional.
- `region` (string): Optional ISO 3166-1 country code for the request. This sets the proxy region and does not filter results to that country only.
- `trim` (boolean): Whether to request a smaller response with fewer fields.

### `tiktok_video_get` (~170 tokens)

Get TikTok video

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

Input parameters:

- `downloadMedia`: When true, includes hosted CDN URLs in `downloads` when available. Adds 10 credits (11 total with the base lookup) on successful lookups, even if `downloads` is empty.
- `getTranscript`: When true, includes the video transcript (WEBVTT) in `transcript` when one is available.
- `region` (string): Optional ISO 3166-1 country code used to route the request when needed.
- `trim`: When true, returns a smaller response with fewer fields.
- `url` (string, required): Link to the video or photo post.

### `tiktok_video_comments_list` (~83 tokens)

List TikTok video comments

List comments on a TikTok video by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque cursor from a previous response to fetch the next page.
- `trim`: When true, returns a smaller response with fewer fields.
- `url` (string, required): Link to the TikTok video whose comments should be listed.

### `tiktok_video_comments_replies_list` (~98 tokens)

List TikTok comment replies

List replies to a TikTok video comment. Accepts a comment id. Returns a list (use cursor when paginated).

Input parameters:

- `commentId` (string, required): Parent comment id from List TikTok video comments (`data.comments[].id`).
- `cursor` (string): Opaque cursor from a previous response to fetch the next page.
- `url` (string, required): Link to the TikTok video that contains the parent comment.

### `tiktok_video_download_get` (~63 tokens)

Download TikTok video or photo post media

Download TikTok video or photo post media. Accepts a video URL.

Input parameters:

- `region` (string): Optional ISO 3166-1 country code used to route the request when needed.
- `url` (string, required): Link to the video or photo post.

### `tiktok_video_transcript_get` (~103 tokens)

Get TikTok video transcript

Get the spoken transcript for a TikTok video by URL.

Input parameters:

- `language` (string): Optional two-letter language code to request a transcript in a specific language when available.
- `url` (string, required): Link to the TikTok video whose transcript should be returned.
- `useAiFallback`: When true, uses Social Fetch's AI fallback when a transcript is not otherwise available. Adds 10 credits on completed lookups (11 total with the base lookup).

### `tiktok_feed_trending_list` (~68 tokens)

List TikTok trending feed

List currently trending TikTok posts for a region. Returns a list (use cursor when paginated).

Input parameters:

- `region` (string, required): Two-letter ISO 3166-1 country code for the request.
- `trim`: When true, requests a smaller response with fewer optional fields.

### `tiktok_song_get` (~55 tokens)

Get TikTok song

Get details for a TikTok song or sound by id.

Input parameters:

- `id` (string, required): TikTok song or sound id. Use the trailing id from a music page URL, or `music.id` from a video lookup.

### `tiktok_music_videos_list` (~71 tokens)

List TikTok music videos

List TikTok videos that use a specific music clip. Accepts a clip id. Returns a list (use cursor when paginated).

Input parameters:

- `clipId` (string, required): TikTok music clip id whose videos should be listed.
- `cursor` (string): Pagination cursor returned by a previous response.

### `tiktok_shop_products_search` (~88 tokens)

Search TikTok Shop products

Search products in TikTok Shop by keyword. Returns a list (use cursor when paginated).

Input parameters:

- `page` (integer): 1-based results page number. Omit to request the first page. Pagination is page-based.
- `query` (string, required): Search query text for TikTok Shop products.
- `region` (string): Optional country or region code for the product search catalog.

### `tiktok_shop_products_list` (~98 tokens)

List TikTok Shop store products

List products in a TikTok Shop store by shop id or URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor from a previous response. Omit to request the first page.
- `region` (string): Optional region code for the shop catalog. When omitted, the default catalog region is US.
- `url` (string, required): Public TikTok Shop store URL whose products should be listed.

### `tiktok_product_get` (~74 tokens)

Get TikTok Shop product

Get details for a TikTok Shop product by product id. Accepts a product page URL.

Input parameters:

- `region` (string): Optional country or region code for the product catalog. When omitted, the default catalog region applies.
- `url` (string, required): Public TikTok Shop product detail page URL for the product to retrieve.

### `tiktok_product_reviews_list` (~132 tokens)

List TikTok Shop product reviews

List buyer reviews for a TikTok Shop product by product id. Returns a list (use cursor when paginated).

Input parameters:

- `page` (integer): 1-based review page number. Omit to request the first page.
- `productId` (string): TikTok Shop product identifier. Provide this instead of `url` when you already know the product id.
- `region` (string): Optional country or region code for the product review catalog. When omitted, the default catalog region applies.
- `url` (string): Public TikTok Shop product detail page URL for the product whose reviews should be listed.

### `tiktok_profile_showcaseProducts_list` (~86 tokens)

List TikTok profile showcase products

List products featured on a creator's TikTok showcase by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `handle` (string, required): TikTok handle whose profile showcase products should be listed.
- `region` (string): Optional ISO 3166-1 country code for the request.

### `tiktok_adLibrary_ad_get` (~68 tokens)

Get TikTok Ad Library ad

Get a single TikTok Ad Library or Top Ads creative by ad id or public ad URL.

Input parameters:

- `adId` (string): TikTok Ad Library or Top Ads ad id.
- `url` (string): Public TikTok Ad Library or Top Ads detail URL for the ad.

### `tiktok_adLibrary_ads_search_get` (~316 tokens)

Search TikTok Ad Library ads

Search TikTok Top Ads by keyword and filters, or search the public Ads Library by advertiser name. Returns a list (use cursor when paginated).

Input parameters:

- `adFormat` (string): Ad format filter for Top Ads. `spark-ads`: ads boosted from an organic creator/brand TikTok post. `non-spark-ads`: ads uploaded directly as ad creative, not boosted from an existing post.
- `adLanguage` (string): Ad language filter for Top Ads.
- `advertiserName` (string): Search the public TikTok Ads Library by advertiser name. When set, results come from the public Ads Library instead of Top Ads.
- `cursor` (string): Opaque pagination cursor from a previous response.
- `duration` (string): Video duration filter for Top Ads.
- `industry` (string): Industry filter for Top Ads.
- `likes` (string): Likes percentile filter for Top Ads.
- `objective` (string): Campaign objective filter for Top Ads.
- `orderBy` (string): Sort metric for Top Ads. `cvr`: conversion rate. `ctr`: click-through rate. `play-2s-rate`/`play-6s-rate`: rate viewers played past the 2s/6s mark. Default: `for-you`.
- `period` (string): Time window in days for Top Ads.
- `query` (string): Optional keyword to search ad titles and content.
- `region` (string): Country code for Top Ads results. Default: `US`.

### `twitter_profile_get` (~51 tokens)

Get Twitter profile

Get an X (Twitter) profile by handle. Returns lookupStatus plus follower/tweet metrics and account age signals.

Input parameters:

- `handle` (string, required): X handle to look up, with or without a leading @.

### `twitter_profile_tweets_list` (~117 tokens)

List Twitter profile tweets

List tweets from an X profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `handle` (string, required): X handle to look up, with or without a leading @.
- `includePinned`: Include pinned tweets on the first page. Default: false.
- `includeReplies`: Include reply tweets in the returned list. Default: false.
- `limit` (integer): Page size (maximum 100). Default: 40.

### `twitter_tweet_get` (~70 tokens)

Get Twitter tweet

Get a single tweet by URL. Author includes profile metrics when not trimmed. Warning: trim=true omits author. Credits: 1.

Input parameters:

- `trim` (boolean): Optional: omit author profile and tweet `core` for a smaller response.
- `url` (string, required): Tweet permalink or identifier.

### `twitter_tweet_replies_list` (~57 tokens)

List Twitter tweet replies

List replies to a tweet by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `url` (string, required): Tweet permalink or identifier.

### `twitter_tweet_transcript_get` (~33 tokens)

Get Twitter tweet transcript

Get the transcript for a video tweet by URL.

Input parameters:

- `url` (string, required): Tweet permalink or identifier.

### `twitter_search_list` (~195 tokens)

Search Twitter posts

Search X posts by free-text keyword (not hashtag — use twitter.hashtag.list for that). Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `endDate` (string): Optional end date filter in YYYY-MM-DD format.
- `language` (string): Optional language filter.
- `limit` (integer): Optional page size. Maximum supported value is 20.
- `minLikes` (integer): Optional minimum like count filter.
- `minReplies` (integer): Optional minimum reply count filter.
- `minRetweets` (integer): Optional minimum retweet count filter.
- `query` (string, required): Search query text to run against public posts on X.
- `section` (string): Optional search section filter. Omit to use the default `top` section.
- `startDate` (string): Optional start date filter in YYYY-MM-DD format.

### `twitter_hashtag_list` (~108 tokens)

Search Twitter by hashtag

Search X posts by hashtag (not free-text keyword — use twitter.search.list for that). Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `hashtag` (string, required): Hashtag to search for.
- `limit` (integer): Optional page size. Maximum supported value is 20.
- `section` (string): Optional section filter for the hashtag feed. Omit to use the default `top` section.

### `twitter_community_get` (~34 tokens)

Get Twitter community

Get details for an X community by community id or URL.

Input parameters:

- `url` (string, required): Community URL to look up.

### `twitter_community_tweets_list` (~46 tokens)

List Twitter community tweets

List tweets from an X community by community id or URL. Returns a list (use cursor when paginated).

Input parameters:

- `url` (string, required): Community URL to look up.

### `telegram_channel_get` (~41 tokens)

Get Telegram channel

Get metadata for a public Telegram channel or group by username.

Input parameters:

- `handle` (string, required): Telegram public username (channel or group), with or without leading @.

### `telegram_channel_posts_get` (~81 tokens)

List Telegram channel posts

List recent posts from a public Telegram channel. Groups are not supported. Accepts a handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response. Omit for the first page.
- `handle` (string, required): Telegram public username (channel or group), with or without leading @.

### `telegram_channel_post_get` (~67 tokens)

Get Telegram channel post

Get a single public post from a Telegram channel by handle and post ID. Groups are not supported.

Input parameters:

- `handle` (string, required): Telegram public username (channel or group), with or without leading @.
- `postId` (string, required): Numeric Telegram channel post ID from the public URL.

### `linktree_profile_get` (~44 tokens)

Get Linktree profile

Get a public Linktree profile by handle, including links and socials.

Input parameters:

- `handle` (string, required): Linktree handle to look up, with or without a leading @.

### `hackernews_search_list` (~384 tokens)

Search Hacker News

Search Hacker News by keyword. Returns a list (use page/pageSize when paginated).

Input parameters:

- `author` (string): Restrict results to items by this Hacker News username.
- `dateRange` (string): Creation-time window. Default: `all`.
- `domain` (string): Restrict search to story URLs matching this domain (e.g. example.com). Can omit `query`.
- `frontPageOnly`: When true, restrict results to current front-page items. Allows omitting `query`.
- `minPoints` (integer): Minimum points/score filter.
- `page` (integer): Zero-based page index (maximum 50 pages, up to 1,000 hits).
- `pageSize`: Hits per page. Must be one of 10, 20, 30, 50. Default: 20.
- `prefix`: When true, enable prefix matching for query tokens.
- `query` (string): Full-text search query. Required unless `frontPageOnly`, `author`, `domain`, or `url` is set.
- `searchAuthor`: When true, include author username in the searchable fields.
- `searchStoryText`: Include story/comment text in searchable fields. Default: true. Set false to search title/URL only.
- `sort` (string): Ranking mode. Default: `popularity`.
- `type` (string): Restrict search results to a Hacker News content type. `ask_hn`: Ask HN posts (questions to the community). `show_hn`: Show HN posts (projects/work being shared). `launch_hn`: Launch HN posts (YC-aff…
- `typoTolerance`: Enable typo tolerance. Default: true.
- `url` (string): Restrict search to story URLs matching this URL substring. Can omit `query`.

### `hackernews_feed_list` (~108 tokens)

List a Hacker News feed

List a Hacker News feed by type (top, new, best, ask, show, or jobs). Accepts a feed name. Returns a list (use offset/limit when paginated).

Input parameters:

- `feed` (string, required): Hacker News feed: top, new, best, ask, show, or jobs.
- `limit` (integer): Maximum items to hydrate (1–50). Default: 30.
- `offset` (integer): Zero-based offset into the official feed id list.

### `hackernews_story_get` (~29 tokens)

Get Hacker News story

Get a Hacker News story by id.

Input parameters:

- `id` (integer, required): Hacker News story id.

### `hackernews_story_comments_list` (~94 tokens)

Get Hacker News story comments

List comments on a Hacker News story by id. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque continuation cursor from a previous response. Omit for the first page.
- `id` (integer, required): Hacker News story id whose comment tree should be returned.
- `limit` (integer): Maximum comment nodes to return in this page (1–100). Default: 50.

### `hackernews_item_get` (~29 tokens)

Get Hacker News item

Get a Hacker News item by id.

Input parameters:

- `id` (integer, required): Hacker News item id.

### `hackernews_comment_context_get` (~42 tokens)

Get Hacker News comment context

Get a Hacker News comment with its ancestor chain to the root story. Accepts a comment id.

Input parameters:

- `id` (integer, required): Hacker News comment id.

### `hackernews_user_get` (~32 tokens)

Get Hacker News user profile

Get a Hacker News user profile by username.

Input parameters:

- `username` (string, required): Hacker News username (case-sensitive).

### `hackernews_user_submissions_list` (~102 tokens)

List Hacker News user submissions

List a Hacker News user's stories, polls, and jobs (newest first). Accepts a username. Returns a list (use page/pageSize when paginated).

Input parameters:

- `page` (integer): Zero-based page index (maximum 50 pages, up to 1,000 hits).
- `pageSize` (integer): Hits per page (1–50). Default: 20.
- `username` (string, required): Hacker News username (case-sensitive).

### `hackernews_user_comments_list` (~96 tokens)

List Hacker News user comments

List a Hacker News user's comments (newest first). Accepts a username. Returns a list (use page/pageSize when paginated).

Input parameters:

- `page` (integer): Zero-based page index (maximum 50 pages, up to 1,000 hits).
- `pageSize` (integer): Hits per page (1–50). Default: 20.
- `username` (string, required): Hacker News username (case-sensitive).

### `hackernews_user_favorites_list` (~74 tokens)

List Hacker News user favorites

List favorites for a Hacker News user by username. Returns a list (use page when paginated; 1-based).

Input parameters:

- `page` (integer): One-based HTML favorites page number. Default: 1. Each page bills 1 credit.
- `username` (string, required): Hacker News username (case-sensitive).

### `hackernews_jobs_who_is_hiring_list` (~112 tokens)

List Who is Hiring jobs

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

Input parameters:

- `month` (string): Calendar month (YYYY-MM) to pin a Who is Hiring thread. Default: latest thread.
- `page` (integer): Zero-based page index of top-level hiring comments.
- `pageSize` (integer): Job rows per page (1–50). Default: 20.

### `hackernews_updates_get` (~20 tokens)

Get Hacker News updates

Get recently changed Hacker News item ids and usernames.

### `hackernews_maxitem_get` (~20 tokens)

Get Hacker News max item id

Get the current largest Hacker News item id.

### `truthsocial_profile_get` (~34 tokens)

Get Truth Social profile

Get a Truth Social profile by handle or account id.

Input parameters:

- `handle` (string, required): Truth Social handle or account id.

### `truthsocial_profile_posts_list` (~125 tokens)

List Truth Social profile posts

List posts from a Truth Social profile by handle or account id. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response. Omit for the first page.
- `handle` (string, required): Truth Social handle or account id.
- `includeReplies`: When true, includes reply posts in the timeline. Adds 2 credits (4 total including the base lookup). Default: false (top-level posts only).
- `limit` (integer): Maximum posts to return (1–20). Default: 20.

### `truthsocial_post_get` (~31 tokens)

Get Truth Social post

Get a Truth Social post by URL.

Input parameters:

- `url` (string, required): Link to the Truth Social post.

### `facebook_profile_get` (~56 tokens)

Get Facebook profile

Get a Facebook profile or Page by URL or username.

Input parameters:

- `includeBusinessHours` (boolean): Optional: include structured business hours in the response when available.
- `url` (string, required): Facebook public profile or page URL to look up.

### `facebook_profile_posts_list` (~89 tokens)

List Facebook profile posts

List posts from a Facebook profile or Page. Accepts a profile URL or page id. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `pageId` (string): Facebook page or profile id when you have it instead of a full URL.
- `url` (string): Full public Facebook profile or page URL.

### `facebook_profile_reels_list` (~72 tokens)

List Facebook profile reels

List Reels from a Facebook profile or Page. Accepts a profile or page URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `url` (string, required): Public Facebook profile or page URL whose reels should be listed.

### `facebook_profile_photos_list` (~71 tokens)

List Facebook profile photos

List photos from a Facebook profile or Page. Accepts a profile or page URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `url` (string, required): Public Facebook profile or page URL whose photos should be listed.

### `facebook_post_get` (~70 tokens)

Get Facebook post or reel

Get a Facebook post or Reel by URL.

Input parameters:

- `includeComments`: When true, includes a sample of top-level comments when available.
- `includeTranscript`: When true, includes a plain-text transcript when available for the video.
- `url` (string, required): Public permalink to the Facebook post or reel.

### `facebook_post_comments_list` (~93 tokens)

List Facebook post or reel comments

List comments on a Facebook post or Reel by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque cursor from a previous response to fetch the next page.
- `feedbackId` (string): Optional Facebook feedback identifier for the target post; when available it can improve lookup performance.
- `url` (string): Link to the Facebook post or reel whose comments should be listed.

### `facebook_post_comments_replies_list` (~62 tokens)

List Facebook comment replies

List replies to a Facebook comment. Accepts a from post comments. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string, required): Comment `repliesCursor` from post comments, or `page.nextCursor` to paginate replies.

### `facebook_post_transcript_get` (~42 tokens)

Get Facebook post transcript

Get the transcript for a Facebook post or Reel by URL.

Input parameters:

- `url` (string, required): Link to the Facebook post or reel whose transcript should be returned.

### `facebook_group_posts_list` (~144 tokens)

List Facebook group posts

List posts from a Facebook group by group URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `sortBy` (string): Optional sort order for posts returned from the group feed. `top`: Facebook's default relevance ranking. `recentActivity`: sorted by most recent comment/reaction activity. `chronological`: regular po…
- `url` (string, required): Public Facebook group URL whose posts should be listed.

### `facebook_marketplace_item_get` (~59 tokens)

Get Facebook Marketplace item

Get details for a Facebook Marketplace listing by item URL.

Input parameters:

- `itemId` (string): Facebook Marketplace item identifier. Provide this instead of url when you already know the item id.
- `url` (string): Public Facebook Marketplace item URL.

### `facebook_marketplace_locations_search` (~57 tokens)

Search Facebook Marketplace locations

Search Facebook Marketplace locations to obtain coordinates for listing search. Accepts a city or place name. Returns a list (use cursor when paginated).

Input parameters:

- `query` (string, required): City or place name to search for Facebook Marketplace locations.

### `facebook_marketplace_search_list` (~379 tokens)

Search Facebook Marketplace listings

Search Facebook Marketplace listings by keyword near a latitude and longitude. Returns a list (use cursor when paginated).

Input parameters:

- `availability` (string): Optional availability filter for marketplace listings.
- `condition` (string): Optional item condition filter for marketplace listings.
- `count` (integer): Optional number of listings to return.
- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `dateListed` (string): Optional date-listed filter for marketplace listings. `1`/`last24Hours` both mean the last 24 hours, `7`/`last7Days` both mean the last 7 days, and `30`/`last30Days` both mean the last 30 days — thes…
- `deliveryMethod` (string): Optional delivery method filter for marketplace listings.
- `lat` (number): Latitude for the marketplace search location.
- `lng` (number): Longitude for the marketplace search location.
- `maxPrice` (number): Optional maximum listing price. Must be greater than or equal to `minPrice` when both are set.
- `minPrice` (number): Optional minimum listing price. Must be less than or equal to `maxPrice` when both are set.
- `query` (string, required): Search query text for marketplace listings.
- `radiusKm` (number): Optional search radius in kilometers.
- `sortBy` (string): Optional sort order for marketplace listings. `suggested`: Facebook's default relevance ranking. `distanceAscend`: nearest first. `creationTimeDescend`: newest listings first. `priceAscend`/`priceDes…

### `facebook_adLibrary_ad_get` (~92 tokens)

Get Facebook Ad Library ad

Get a single Facebook Ad Library ad by archive id or public Ad Library URL.

Input parameters:

- `adId` (string): Facebook Ad Library archive id for the ad.
- `includeTranscript`: When true, includes a plain-text transcript when available for the ad video.
- `trim`: When true, requests a smaller payload before normalization.
- `url` (string): Public Facebook Ad Library URL for the ad.

### `facebook_adLibrary_ads_search_get` (~202 tokens)

Search Facebook Ad Library ads

Search Facebook Ad Library ads by keyword and filters. Returns a list (use cursor when paginated).

Input parameters:

- `adType` (string): Optional filter for all ads or political and issue ads.
- `country` (string): Optional country code filter. Use ALL to search all countries.
- `cursor` (string): Opaque pagination cursor from a previous response.
- `endDate` (string): Optional end date filter in YYYY-MM-DD format.
- `mediaType` (string): Optional creative media filter.
- `query` (string, required): Search query text for Facebook Ad Library ads.
- `searchType` (string): Optional keyword matching mode for the search query.
- `sortBy` (string): Optional sort order for returned ads.
- `startDate` (string): Optional start date filter in YYYY-MM-DD format.
- `status` (string): Optional ad status filter.
- `trim` (boolean): When true, returns a smaller response with fewer fields.

### `facebook_company_ads_list` (~200 tokens)

List Facebook company ads

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

Input parameters:

- `companyName` (string): Company or page name to search when you do not have a page id.
- `country` (string): Optional country code filter. Use ALL to search all countries.
- `cursor` (string): Opaque pagination cursor from a previous response.
- `endDate` (string): Optional end date filter in YYYY-MM-DD format.
- `language` (string): Optional language code filter.
- `mediaType` (string): Optional creative media filter.
- `pageId` (string): Facebook page id when you have it instead of a company name.
- `sortBy` (string): Optional sort order for returned ads.
- `startDate` (string): Optional start date filter in YYYY-MM-DD format.
- `status` (string): Optional ad status filter.

### `facebook_adLibrary_companies_search` (~53 tokens)

Search Facebook ad library companies

Search Facebook Ad Library companies / advertisers by name. Accepts a company name. Returns a list (use cursor when paginated).

Input parameters:

- `query` (string, required): Search query text for Facebook ad library companies.

### `google_company_ads_list` (~187 tokens)

List Google company ads

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

Input parameters:

- `advertiserId` (string): Google Ad Transparency advertiser id when you have it instead of a domain.
- `cursor` (string): Opaque pagination cursor from a previous response.
- `domain` (string): Company domain when you do not have an advertiser id.
- `endDate` (string): Optional end date filter in YYYY-MM-DD format.
- `format` (string): Optional creative format filter.
- `platform` (string): Optional Google surface filter.
- `region` (string): Optional region filter as a two-letter country code.
- `startDate` (string): Optional start date filter in YYYY-MM-DD format.
- `topic` (string): Optional topic filter. When `political`, `region` is required.

### `google_adLibrary_ad_get` (~39 tokens)

Get Google Ad Library ad

Get a single Google Ad Transparency creative by public Ad Transparency URL.

Input parameters:

- `url` (string, required): Public Google Ad Transparency URL for the creative.

### `google_adLibrary_advertisers_search` (~71 tokens)

Search Google Ad Library advertisers

Search Google Ad Transparency advertisers by name. Accepts a advertiser name. Returns a list (use cursor when paginated).

Input parameters:

- `query` (string, required): Search query text for Google Ad Transparency advertisers.
- `region` (string): Two-letter country code to search in. Default: `US`.

### `instagram_profile_get` (~55 tokens)

Get Instagram profile

Get a full Instagram profile by handle (bio, counts, and related fields). Returns lookupStatus plus follower/post metrics and privacy flags.

Input parameters:

- `handle` (string, required): Instagram handle to look up, with or without a leading @.

### `instagram_profile_engagement_get` (~41 tokens)

Get Instagram profile engagement audit

Get Instagram profile engagement audit. Accepts a handle.

Input parameters:

- `handle` (string, required): Instagram handle to look up, with or without a leading @.

### `instagram_profile_basic_get` (~41 tokens)

Get Instagram basic profile

Get a lightweight Instagram profile by numeric user ID when you already have the id.

Input parameters:

- `userId` (string, required): Instagram numeric user id to look up.

### `instagram_profile_posts_list` (~58 tokens)

List Instagram profile posts

List posts from an Instagram profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `handle` (string, required): Instagram handle whose posts should be listed.

### `instagram_profile_reels_list` (~88 tokens)

List Instagram profile reels

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). Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `handle` (string, required): Instagram handle whose reels should be listed.

### `instagram_profile_highlights_list` (~48 tokens)

List Instagram profile highlights

List story highlight albums for an Instagram profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `handle` (string, required): Instagram handle whose story highlight albums should be listed.

### `instagram_highlight_get` (~37 tokens)

Get Instagram highlight

Get stories inside a saved Instagram highlight by highlight id.

Input parameters:

- `highlightId` (string, required): Numeric Instagram highlight id from a highlight URL.

### `instagram_search_profiles_list` (~55 tokens)

Search Instagram profiles

Search Instagram profiles by keyword. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `query` (string, required): Search query text for Instagram profiles.

### `instagram_search_reels_list` (~119 tokens)

Search Instagram Reels

Search Reels site-wide by keyword (optional date filters and page-based pagination) — not scoped to one profile (use instagram.profile.reels.list) and not trending (use instagram.reels.trending.list). Returns a list (use cursor when paginated).

Input parameters:

- `datePosted` (string): Optional filter for when matching reels were posted.
- `page` (integer): 1-based results page number. Omit to request the first page. Pagination is page-based.
- `query` (string, required): Search query text for Instagram Reels.

### `instagram_search_hashtag_list` (~114 tokens)

Search Instagram by hashtag

Search public Instagram posts and Reels by hashtag. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `datePosted` (string): Optional filter for when matching posts were posted.
- `hashtag` (string, required): Hashtag to search for. A leading # is optional.
- `mediaType` (string): Content filter. Use `all` for posts and Reels, or `reels` for Reels only. Default: `all`.

### `instagram_post_get` (~109 tokens)

Get Instagram post or reel

Get a single Instagram post or Reel by URL. Author is under owner (not author); timestamps use takenAt.

Input parameters:

- `downloadMedia`: When true, returns permanent CDN URLs for media in `downloads`. Adds 10 credits (11 total including the base lookup).
- `region` (string): Optional ISO 3166-1 country code for request routing.
- `trim`: When true, returns a smaller response with fewer fields.
- `url` (string, required): Link to the post or reel.

### `instagram_post_comments_list` (~69 tokens)

List Instagram post or reel comments

List comments on an Instagram post or Reel by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque cursor from a previous response to fetch the next page.
- `url` (string, required): Link to the Instagram post or reel whose comments should be listed.

### `instagram_post_comments_replies_list` (~105 tokens)

List Instagram comment replies

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

Input parameters:

- `commentId` (string, required): Parent comment id from List Instagram post or reel comments (`data.comments[].id`).
- `cursor` (string): Opaque cursor from a previous response to fetch the next page.
- `url` (string, required): Link to the Instagram post or reel that contains the parent comment.

### `instagram_post_download_get` (~55 tokens)

Download Instagram post or reel media

Download Instagram post or reel media. Accepts a post URL.

Input parameters:

- `region` (string): Optional ISO 3166-1 country code for request routing.
- `url` (string, required): Link to the post or reel.

### `instagram_post_transcript_get` (~43 tokens)

Get Instagram post transcript

Get the spoken transcript for an Instagram post or Reel by URL.

Input parameters:

- `url` (string, required): Link to the Instagram post or Reel whose transcript should be returned.

### `instagram_reels_trending_list` (~53 tokens)

List trending Instagram Reels

List currently trending Instagram Reels (not a keyword search or profile-scoped — use instagram.search.reels.list or instagram.profile.reels.list for that). Returns a list (use cursor when paginated).

### `pinterest_profile_boards_list` (~79 tokens)

List Pinterest profile boards

List public boards for a Pinterest profile. Accepts a handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `handle` (string, required): Pinterest username whose boards should be listed.
- `trim`: When true, returns a smaller response with fewer fields.

### `pinterest_board_pins_list` (~74 tokens)

List Pinterest board pins

List public pins on a Pinterest board by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `trim`: When true, returns a smaller response with fewer fields.
- `url` (string, required): Link to the Pinterest board.

### `pinterest_pin_get` (~44 tokens)

Get Pinterest pin

Fetch a public Pinterest pin by URL.

Input parameters:

- `trim`: When true, returns a smaller response with fewer fields.
- `url` (string, required): Link to the Pinterest pin.

### `pinterest_search_pins_list` (~72 tokens)

Search Pinterest pins

Search public Pinterest pins by keyword. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `query` (string, required): Search query text for Pinterest pins.
- `trim`: When true, returns a smaller response with fewer fields.

### `threads_profile_get` (~43 tokens)

Get Threads profile

Get a Threads profile for a creator or account. Accepts a handle.

Input parameters:

- `handle` (string, required): Threads handle to look up, with or without a leading @.

### `threads_profile_posts_list` (~63 tokens)

List Threads profile posts

List posts from a Threads profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `handle` (string, required): Threads handle whose posts should be listed.
- `trim` (boolean): When true, returns a smaller response with fewer post fields when available.

### `threads_post_get` (~44 tokens)

Get Threads post

Get a single Threads post by URL.

Input parameters:

- `trim`: When true, returns a smaller response with fewer fields.
- `url` (string, required): Link to the Threads post.

### `threads_search_list` (~87 tokens)

Search Threads posts

Search Threads posts by keyword. Returns a list (use cursor when paginated).

Input parameters:

- `endDate` (string): Optional end date filter in YYYY-MM-DD format.
- `query` (string, required): Search query text for public Threads posts.
- `startDate` (string): Optional start date filter in YYYY-MM-DD format.
- `trim`: Whether to request a smaller response shape when available.

### `threads_users_search` (~38 tokens)

Search Threads users

Search Threads users by keyword. Returns a list (use cursor when paginated).

Input parameters:

- `query` (string, required): Search query text for Threads users.

### `bluesky_profile_get` (~46 tokens)

Get Bluesky profile

Get a Bluesky profile for a creator or account. Accepts a handle.

Input parameters:

- `handle` (string, required): Bluesky handle to look up, with or without a leading @.

### `bluesky_profile_posts_list` (~78 tokens)

List Bluesky profile posts

List posts from a Bluesky profile by handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `handle` (string, required): Bluesky handle whose posts should be listed.
- `userId` (string): Optional Bluesky user id to speed up the request.

### `bluesky_post_get` (~32 tokens)

Get Bluesky post

Get a single Bluesky post by URL.

Input parameters:

- `url` (string, required): Link to the Bluesky post.

### `linkedin_profile_get` (~40 tokens)

Get LinkedIn profiles

Get LinkedIn person profiles by URL or handle. Returns a list (use cursor when paginated).

Input parameters:

- `url` (array): LinkedIn profile URL.

### `linkedin_profiles_posts_list` (~186 tokens)

List LinkedIn profile posts

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

Input parameters:

- `endDate` (string): Optional end of the date range for posts to include. Must be a valid ISO-8601 date-time. For profile URLs, date filtering applies only to LinkedIn articles.
- `limit` (integer): Maximum posts to return (default 10).
- `onlyAuthoredPosts`: When true, return only posts created by the profile owner.
- `startDate` (string): Optional start of the date range for posts to include. Must be a valid ISO-8601 date-time. For profile URLs, date filtering applies only to LinkedIn articles.
- `url` (string, required): LinkedIn profile URL or vanity handle whose public posts should be listed.

### `linkedin_organization_get` (~53 tokens)

Get LinkedIn organization page

Look up LinkedIn company, school, or organization pages by URL (broader than linkedin.company.get). Returns a list (use cursor when paginated).

Input parameters:

- `url` (array): LinkedIn organization page URL.

### `linkedin_company_get` (~66 tokens)

Get LinkedIn company page

Get a LinkedIn company page by company URL — use linkedin.organization.get for schools and mixed organization URLs.

Input parameters:

- `url` (string, required): LinkedIn company page URL for this lookup. School and organization-guest pages are not supported; use `GET /v1/linkedin/organizations`.

### `linkedin_company_posts_list` (~98 tokens)

List LinkedIn company posts

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

Input parameters:

- `page` (integer): 1-based results page number. Pagination is page-based; at most 7 pages can be requested for a given company.
- `url` (string, required): LinkedIn company page URL or slug whose posts should be listed.

### `linkedin_post_get` (~33 tokens)

Get LinkedIn post or article

Get a LinkedIn post or article by URL.

Input parameters:

- `url` (string, required): Public permalink to the post or article.

### `linkedin_post_transcript_get` (~42 tokens)

Get LinkedIn post transcript

Get the transcript for a LinkedIn post video by URL.

Input parameters:

- `url` (string, required): Link to the LinkedIn post whose video transcript should be returned.

### `linkedin_people_search_list` (~85 tokens)

Search LinkedIn people

Search LinkedIn people by first and/or last name. Returns a list (use cursor when paginated).

Input parameters:

- `firstName` (string): First name filter. At least one of `firstName` or `lastName` is required.
- `lastName` (string): Last name filter. At least one of `firstName` or `lastName` is required.

### `linkedin_posts_search_list` (~103 tokens)

Search LinkedIn posts

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 paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `datePosted` (string): Optional filter for how recently matching posts were published.
- `query` (string, required): Keyword or phrase to search for in public LinkedIn posts.

### `linkedin_adLibrary_ad_get` (~58 tokens)

Get LinkedIn Ad Library ad

Get a LinkedIn Ad Library ad by ad id or Ad Library URL.

Input parameters:

- `adId` (string): LinkedIn Ad Library id for the ad.
- `url` (string): Public LinkedIn Ad Library URL for the ad.

### `linkedin_adLibrary_ads_search_list` (~164 tokens)

Search LinkedIn Ad Library ads

Search LinkedIn Ad Library ads by company, keyword, or company id. Returns a list (use cursor when paginated).

Input parameters:

- `company` (string): Company name to search for in the LinkedIn Ad Library.
- `companyId` (string): LinkedIn company id to search for in the Ad Library.
- `countries` (string): Optional comma-separated list of country codes (for example US,CA,MX).
- `cursor` (string): Opaque pagination cursor from a previous response.
- `endDate` (string): Optional end date filter in YYYY-MM-DD format.
- `keyword` (string): Keyword or phrase to search for in LinkedIn Ad Library ads.
- `startDate` (string): Optional start date filter in YYYY-MM-DD format.

### `linkedin_jobs_get` (~43 tokens)

Get LinkedIn jobs

Get LinkedIn job postings by job URL. Returns a list (use cursor when paginated).

Input parameters:

- `url` (array): LinkedIn job posting URL to look up.

### `linkedin_jobs_search_list` (~258 tokens)

Search LinkedIn jobs

Search LinkedIn jobs by keyword and filters. Returns a list (use cursor when paginated).

Input parameters:

- `company` (string): Optional company name filter.
- `country` (string): Optional ISO 3166-1 alpha-2 country code, e.g. "GB" or "US". Narrows an ambiguous `location` label to one country; leave unset when `location` is already a country name.
- `experienceLevel` (string): Optional experience level filter.
- `jobType` (string): Optional job type filter.
- `keyword` (string, required): Required. Search keyword for LinkedIn job listings — a job title, skill, or company term, e.g. "typescript engineer" or "growth marketer".
- `limit` (integer): Maximum job listings to return (default 10).
- `location` (string, required): Required. Location label as you would type it into LinkedIn's location box — a city, region, or country name, e.g. "London", "Greater Seattle Area", or "United Kingdom".
- `locationRadius` (string): Optional location radius filter.
- `remote` (string): Optional work arrangement filter.
- `timeRange` (string): Optional time range filter for when jobs were posted.

### `reddit_subreddit_get` (~62 tokens)

Get Reddit subreddit

Get details for a Reddit community (subreddit).

Input parameters:

- `subreddit` (string): Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing.
- `url` (string): Optional subreddit URL for the request.

### `reddit_subreddit_posts_list` (~129 tokens)

List Reddit subreddit posts

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

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `sort` (string): Optional sort order for the returned posts.
- `subreddit` (string, required): Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Lists posts for this subreddit.
- `timeframe` (string): Optional timeframe used with time-based sort orders.

### `reddit_post_comments_list` (~83 tokens)

List Reddit post comments

List comments on a Reddit post by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque cursor from a previous response to fetch another page of comments or replies.
- `trim`: When true, requests a lighter response shape when available.
- `url` (string, required): Link to the Reddit post whose comments should be listed.

### `reddit_post_transcript_get` (~76 tokens)

Get Reddit post transcript

Get captions transcript for a Reddit video post. Accepts a post or video URL.

Input parameters:

- `language` (string): Optional ISO 639-1 language code (two letters) to prefer when multiple caption tracks exist.
- `url` (string, required): Link to the Reddit post or direct hosted video URL whose transcript should be returned.

### `reddit_subreddit_search_list` (~147 tokens)

Search Reddit subreddit

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

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `query` (string): Search text to match against public subreddit posts.
- `sort` (string): Sort order for search results. Default: `relevance`.
- `subreddit` (string, required): Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Searches posts within this subreddit.
- `timeframe` (string): Time range filter for search results. Default: `all`.

### `reddit_search_list` (~114 tokens)

Search Reddit posts

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

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `query` (string, required): Search query text for public Reddit posts.
- `sortBy` (string): Optional sort order for search results.
- `timeframe` (string): Optional time range filter for search results.
- `trim`: Whether to request a smaller response shape when available.

### `rumble_channel_videos_list` (~64 tokens)

List Rumble channel videos

List videos and Shorts from a Rumble channel. Accepts a channel URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Page number from a previous response.
- `url` (string, required): Link to the Rumble channel.

### `rumble_search_list` (~57 tokens)

Search Rumble

Search Rumble for videos and Shorts by keyword. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Page number from a previous response.
- `query` (string, required): Search query text for Rumble content.

### `rumble_video_get` (~33 tokens)

Get Rumble video

Get metadata for a Rumble video by URL.

Input parameters:

- `url` (string, required): Link to the Rumble video.

### `rumble_video_transcript_get` (~41 tokens)

Get Rumble video transcript

Get captions for a Rumble video when available. Accepts a video URL.

Input parameters:

- `url` (string, required): Link to the Rumble video.

### `rumble_video_comments_list` (~50 tokens)

List Rumble video comments

List top-level comments on a Rumble video. Accepts a video URL. Returns a list (use cursor when paginated).

Input parameters:

- `url` (string, required): Link to the Rumble video.

### `twitch_profile_get` (~38 tokens)

Get Twitch profile

Get a Twitch profile for a channel by handle.

Input parameters:

- `handle` (string, required): Twitch handle to look up, with or without a leading @.

### `twitch_profile_videos_list` (~120 tokens)

List Twitch profile videos

List videos from a Twitch channel by handle. Returns a list (use cursor when paginated).

Input parameters:

- `filterBy` (string): Optional filter for the type of Twitch videos to return. `archive`: full unedited past broadcasts (VODs). `highlight`: shorter clips curated/edited by the streamer from past broadcasts. `upload`: vid…
- `handle` (string, required): Twitch handle to look up, with or without a leading @.
- `sortBy` (string): Optional sort order.

### `twitch_profile_schedule_get` (~40 tokens)

Get Twitch profile schedule

Get the stream schedule for a Twitch channel by handle.

Input parameters:

- `handle` (string, required): Twitch handle to look up, with or without a leading @.

### `twitch_clip_get` (~33 tokens)

Get Twitch clip

Get metadata and playback URLs for a Twitch clip by URL.

Input parameters:

- `url` (string, required): Link to the Twitch clip.

### `github_profile_get` (~45 tokens)

Get GitHub profile

Get a GitHub profile for a user or organization. Accepts a username.

Input parameters:

- `handle` (string, required): GitHub username to look up, with or without a leading @.

### `github_profile_repositories_list` (~143 tokens)

List GitHub profile repositories

List repositories for a GitHub user or organization. Accepts a username. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous response.
- `direction` (string): Sort direction.
- `handle` (string, required): GitHub username whose public repositories should be listed.
- `sort` (string): Sort field for repositories.
- `type` (string): Repository type filter. `owner`: repos owned by the user. `all`: owned repos plus repos from organizations the user belongs to. `member`: only repos the user belongs to via organization membership (n…

### `github_repositories_get` (~32 tokens)

Get GitHub repository

Get a single GitHub repository by URL.

Input parameters:

- `url` (string, required): Full public GitHub repository URL.

### `github_profile_activity_list` (~106 tokens)

List GitHub profile activity

List recent public activity for a GitHub profile, one month per request. Accepts a username. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor from a previous response (`data.page.nextCursor`). Pages backward one month at a time through the selected year.
- `handle` (string, required): GitHub username whose public activity timeline should be listed.
- `year` (integer): Calendar year to read activity for. Default: current calendar year.

### `github_profile_followers_list` (~69 tokens)

List GitHub profile followers

List followers for a GitHub profile. Accepts a username. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor from a previous response (numeric page index as a string).
- `handle` (string, required): GitHub username whose followers should be listed.

### `github_profile_following_list` (~70 tokens)

List GitHub profile following

List accounts a GitHub profile follows. Accepts a username. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Pagination cursor from a previous response (numeric page index as a string).
- `handle` (string, required): GitHub username whose following list should be listed.

### `github_profile_contributions_get` (~69 tokens)

Get GitHub contribution graph

Get the contribution graph for a GitHub profile for a given year. Accepts a username.

Input parameters:

- `handle` (string, required): GitHub username to look up, with or without a leading @.
- `year` (integer): Calendar year for the contribution graph. Default: current calendar year.

### `github_trending_repositories_list` (~74 tokens)

List trending GitHub repositories

List trending GitHub repositories for a language and time window. Returns a list (use cursor when paginated).

Input parameters:

- `language` (string): Optional coding language filter.
- `since` (string): Trending time window. Default: `daily`.
- `spokenLanguageCode` (string): Optional spoken language code filter.

### `github_trending_developers_list` (~62 tokens)

List trending GitHub developers

List trending GitHub developers for a language and time window. Returns a list (use cursor when paginated).

Input parameters:

- `language` (string): Optional trending coding language filter.
- `since` (string): Trending time window. Default: `daily`.

### `spotify_artist_get` (~48 tokens)

Get Spotify artist

Get a Spotify artist by id or profile URL.

Input parameters:

- `artistId` (string): Optional Spotify artist id for the request.
- `url` (string): Optional Spotify artist URL for the request.

### `spotify_album_get` (~48 tokens)

Get Spotify album

Get a Spotify album by id or album URL.

Input parameters:

- `albumId` (string): Optional Spotify album id for the request.
- `url` (string): Optional Spotify album URL for the request.

### `spotify_track_get` (~48 tokens)

Get Spotify track

Get a Spotify track by id or track URL.

Input parameters:

- `trackId` (string): Optional Spotify track id for the request.
- `url` (string): Optional Spotify track URL for the request.

### `soundcloud_profile_get` (~38 tokens)

Get SoundCloud profile

Get a SoundCloud profile by handle.

Input parameters:

- `handle` (string, required): SoundCloud handle to look up, with or without a leading @.

### `soundcloud_profile_tracks_list` (~67 tokens)

List SoundCloud profile tracks

List a SoundCloud profile's tracks, newest first. Accepts a handle. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous response.
- `handle` (string, required): SoundCloud handle whose tracks should be listed.

### `soundcloud_track_get` (~31 tokens)

Get SoundCloud track

Get a SoundCloud track by URL.

Input parameters:

- `url` (string, required): Link to the SoundCloud track.

### `youtube_channel_get` (~79 tokens)

Get YouTube channel

Get YouTube channel details by channel id, handle, or URL. Returns channel metrics and identifiers for snapshot baselines.

Input parameters:

- `channelId` (string): Optional YouTube channel id for the request.
- `handle` (string): Optional YouTube channel handle for the request.
- `url` (string): Optional YouTube channel URL for the request.

### `youtube_channel_videos_list` (~131 tokens)

List YouTube channel videos

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

Input parameters:

- `channelId` (string): Optional YouTube channel id for the request.
- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `handle` (string): Optional YouTube channel handle for the request.
- `includeExtras` (boolean): Optional flag to include richer per-video metadata when available.
- `sortBy` (string): Optional sort order for the returned YouTube videos.

### `youtube_channel_shorts_list` (~106 tokens)

List YouTube channel shorts

List Shorts from a YouTube channel (not long-form videos). Accepts a channel id or handle. Returns a list (use cursor when paginated).

Input parameters:

- `channelId` (string): Optional YouTube channel id for the request.
- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `handle` (string): Optional YouTube channel handle for the request.
- `sortBy` (string): Optional sort order for the returned YouTube Shorts.

### `youtube_playlist_get` (~48 tokens)

Get YouTube playlist

Get a YouTube playlist by playlist id.

Input parameters:

- `playlistId` (string, required): YouTube playlist id, or a YouTube playlist URL (the `list` query value is used when present).

### `youtube_community_post_get` (~33 tokens)

Get YouTube community post

Get a YouTube community post by URL.

Input parameters:

- `url` (string, required): Public YouTube community post URL.

### `youtube_search_list` (~181 tokens)

Search YouTube

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

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `duration` (string): Optional duration filter for video results. Applies to videos, not shorts.
- `includeExtras` (boolean): When true, returns richer per-video metadata when available. May increase response time.
- `query` (string, required): Search query text for YouTube content.
- `region` (string): Optional ISO 3166-1 country code for localized search results.
- `sortBy` (string): Optional sort order for search results.
- `type` (string): Optional content type filter for search results.
- `uploadDate` (string): Optional upload date filter for video results.

### `youtube_search_hashtag_list` (~84 tokens)

Search YouTube by hashtag

Search YouTube content by hashtag (not free-text keyword — use youtube.search.list for that). Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque pagination cursor returned by a previous response.
- `hashtag` (string, required): Hashtag to search for. A leading # is optional.
- `type` (string): Optional content filter.

### `youtube_video_get` (~69 tokens)

Get YouTube video

Get a single YouTube video by URL. Channel lives under channel (not author); publish time is publishedAt.

Input parameters:

- `language` (string): Optional preferred language for returned text when the source supports localization.
- `url` (string, required): Link to the YouTube video. Shorts URLs are also supported.

### `youtube_video_comments_list` (~95 tokens)

List YouTube video comments

List comments on a YouTube video by URL. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string): Opaque cursor from a previous response to fetch the next page.
- `order` (string): Comment sort order. `top` returns highest-ranked comments; `newest` returns the most recent comments.
- `url` (string, required): Link to the YouTube video whose comments should be listed.

### `youtube_video_comments_analysis_get` (~63 tokens)

Analyze YouTube video comments

Analyze YouTube video comments. Accepts a video URL.

Input parameters:

- `order` (string): Comment sort order to analyze. Defaults to `top` for the strongest signal.
- `url` (string, required): Link to the YouTube video whose comments should be listed.

### `youtube_video_comments_replies_list` (~64 tokens)

List YouTube comment replies

List replies to a YouTube comment. Accepts a from video comments. Returns a list (use cursor when paginated).

Input parameters:

- `cursor` (string, required): Comment `repliesCursor` from Video Comments endpoint, or `page.nextCursor` to paginate replies.

### `youtube_video_transcript_get` (~65 tokens)

Get YouTube video transcript

Get the transcript for a YouTube video by URL.

Input parameters:

- `language` (string): Optional ISO 639-1 language code (two letters) to prefer when multiple transcripts exist.
- `url` (string, required): Link to the YouTube video whose transcript should be returned.

### `youtube_shorts_trending_list` (~29 tokens)

List trending YouTube Shorts

List currently trending YouTube Shorts. Returns a list (use cursor when paginated).

### `web_search_run` (~111 tokens)

Search the web

Search the public web and return ranked organic results with snippets. Accepts a query. Returns a list (use cursor when paginated).

Input parameters:

- `datePosted` (string): Optional filter by when results were posted.
- `page` (integer): Page number (1-based). Default: 1.
- `query` (string, required): Search query text to run against the public web.
- `region` (string): ISO 3166-1 country code for localized results (e.g. US, GB, CA).

### `web_markdown_generate` (~186 tokens)

Generate web page markdown

Convert a web page URL into clean markdown.

Input parameters:

- `cacheMode` (string): Cache behavior. `enabled`: read from cache if present, else fetch and write to cache. `bypass`: always fetch fresh, ignoring and not updating the cache. `write_only`: always fetch fresh, but write th…
- `filter` (string): Markdown extraction filter. `fit`: strip boilerplate and extract the main readable content. `raw`: full unfiltered page markdown, no content pruning. `bm25`: rank and return only the content most rel…
- `query` (string): Optional query string used by the bm25 filter to rank relevant content.
- `url` (string, required): Web page URL to fetch.

### `web_ask_run` (~61 tokens)

Ask a question about a web page

Ask a natural-language question about a specific web page and get an LLM-generated answer. Accepts a URL.

Input parameters:

- `q` (string, required): Natural-language question to answer about the page content.
- `url` (string, required): Web page URL to fetch.

### `web_html_generate` (~30 tokens)

Generate web page HTML

Fetch cleaned HTML for a web page URL.

Input parameters:

- `url` (string, required): Web page URL to fetch.

### `web_crawl_run` (~60 tokens)

Crawl web pages

Crawl a small set of web pages synchronously. Accepts a URLs. Returns a list (use cursor when paginated).

Input parameters:

- `url` (array): URLs to crawl. Repeat the `url` query parameter for multiple pages (max 5).

### `nl_ask_post` (~64 tokens)

Ask in natural language

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.

Input parameters:

- `query` (string, required): Natural-language question to route to a public API lookup.

### `auth_whoami` (~19 tokens)

Whoami

Get the authenticated API account for this session.

### `billing_balance_get` (~22 tokens)

Get account balance

Get remaining credit balance before running large batches of metered tools.

### `docs_search` (~127 tokens)

Search SocialFetch docs

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/field-crosswalk.

Input parameters:

- `currentDocsPathname` (string): Optional current SocialFetch docs pathname, such as /docs/sdk or /product/guides/..., to boost nearby results.
- `limit` (integer): Maximum number of docs results to return.
- `query` (string, required): Natural-language description of what to find in SocialFetch docs (at least 2 characters).

### `docs_read` (~133 tokens)

Read SocialFetch docs page

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 /product/ask-ai/field-crosswalk).

Input parameters:

- `docsPathname` (string, required): Corpus pathname from docs_search, e.g. /docs/api/v1/tiktok/videos/get or /product/ask-ai/field-crosswalk. Trailing .mdx accepted.
- `mode` (string): outline (default) = compact params/credits/field digest. full = complete page including Examples.

### `monitors_sources_list` (~39 tokens)

List watchable sources

List every public API operation Monitors can watch (Twitter/X, Instagram, TikTok, Reddit profiles and searches). Powers the monitor-creation flow.

### `monitors_create` (~170 tokens)

Create a monitor

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 webhooks for items after that.

Input parameters:

- `expression` (string): Cron expression, required when type is cron.
- `minutes` (integer): Required when type is interval.
- `name` (string)
- `operationId` (string, required): A watchable operationId from monitors_sources_list.
- `params` (object, required): Params for the source, e.g. { handle: "elonmusk" }.
- `spendCapCredits` (integer)
- `timezone` (string): IANA timezone, required when type is cron.
- `type` (string, required): interval or cron.
- `webhookEndpointId` (string)

### `monitors_list` (~26 tokens)

List monitors

List the caller's monitors, optionally filtered by status.

Input parameters:

- `status` (string)

### `monitors_get` (~21 tokens)

Get a monitor

Get one monitor by id.

Input parameters:

- `id` (string, required)

### `monitors_update` (~92 tokens)

Update a monitor

Update a monitor's name, schedule, webhook endpoint, spend cap, or status (pause/resume).

Input parameters:

- `expression` (string)
- `id` (string, required)
- `minutes` (integer)
- `name` (string)
- `spendCapCredits`
- `status` (string)
- `timezone` (string)
- `type` (string)
- `webhookEndpointId`

### `monitors_delete` (~25 tokens)

Delete a monitor

Permanently delete a monitor. Cannot be undone.

Input parameters:

- `id` (string, required)

### `monitors_trigger` (~36 tokens)

Manually trigger a monitor poll

Queue an immediate check for an active monitor (async — returns once queued, not once the check finishes).

Input parameters:

- `id` (string, required)

### `monitors_events_list` (~46 tokens)

List monitor events

Pull API for a monitor's events — queryable regardless of webhook delivery configuration.

Input parameters:

- `cursor` (string)
- `id` (string, required)
- `limit` (integer)

### `monitors_checks_list` (~42 tokens)

List a monitor's recent check history

The self-serve "why didn't I get a webhook" view — the last ~50 checks with outcome/credits/reason.

Input parameters:

- `id` (string, required)

### `webhookEndpoints_create` (~69 tokens)

Create a webhook endpoint

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.

Input parameters:

- `description` (string)
- `kind` (string, required)
- `url` (string)

### `webhookEndpoints_list` (~21 tokens)

List webhook endpoints

List the caller's webhook endpoints (secret material never included).

### `webhookEndpoints_get` (~28 tokens)

Get a webhook endpoint

Get one webhook endpoint by id (secret material never included).

Input parameters:

- `id` (string, required)

### `webhookEndpoints_update` (~42 tokens)

Update a webhook endpoint

Update a webhook endpoint's description or enable/disable it.

Input parameters:

- `description` (string)
- `id` (string, required)
- `status` (string)

### `webhookEndpoints_delete` (~27 tokens)

Delete a webhook endpoint

Permanently delete a webhook endpoint. Cannot be undone.

Input parameters:

- `id` (string, required)

### `webhookEndpoints_test` (~45 tokens)

Send a test webhook event

Send a realistic per-source sample event to a webhook endpoint right now — a live, synchronous delivery test.

Input parameters:

- `id` (string, required)
- `sampleType` (string)

### `webhookEndpoints_rotateSecret` (~45 tokens)

Rotate a webhook endpoint secret

Rotate the signing secret with a 24h overlap window — the old secret keeps working until it expires. The new secret is returned once.

Input parameters:

- `id` (string, required)

### `webhookEndpoints_deliveries_list` (~59 tokens)

List deliveries for a webhook endpoint

List delivery attempts for a webhook endpoint, optionally filtered by status or an `after` cursor (ISO timestamp) for tailing.

Input parameters:

- `after` (string)
- `id` (string, required)
- `status` (string)

### `webhookDeliveries_redeliver` (~31 tokens)

Manually redeliver a webhook delivery

Queue a manual redelivery for one delivery attempt (async).

Input parameters:

- `id` (string, required)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/social-freak-ltd-socialfetch/api#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 69
- 2026-08-01: 68
- 2026-07-31: 68
- 2026-07-30: 67
- 2026-07-29: 66
- 2026-07-28: 67
- 2026-07-27: 66
- 2026-07-26: 66

## Links

- Remote endpoint: https://api.socialfetch.dev/mcp
- Repository: https://github.com/social-freak-ltd/socialfetch-mcp
- Website: https://www.socialfetch.dev/docs/integrations/mcp
- Changelog RSS feed: https://verifymcp.io/servers/social-freak-ltd-socialfetch/api/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/social-freak-ltd-socialfetch/api/changelog.json
- HTML version of this page: https://verifymcp.io/servers/social-freak-ltd-socialfetch/api
