# Social Media Data API

> Social Media Data API is a paid MCP server for marketing and seo. Social listening data from X, Reddit, TikTok, YouTube and more, paid per call. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://social.duoleads.com
- **Repository:** https://github.com/hiesem/x402-social-media-data
- **MCP Registry name:** com.duoleads.social/social-media-data
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-14

## About

A partial answer still gets charged here, a detail worth knowing before you hand it to an agent: a 200 response marked complete: false is billed, while bad input, no match, or a total upstream failure are not. Calls cost $0.01 to $0.025 in USDC on Base over x402, with no account or API key.

The service has 26 routes returning public posts, profiles, comments and video transcripts in one shared JSON schema. Platform coverage includes Bluesky, Hacker News, X, Reddit, TikTok, Instagram, YouTube, Threads, the Meta Ad Library and LinkedIn company pages. Beyond per-platform routes, there are cross-platform ones: mentions with aggregate sentiment, search across X, Reddit and TikTok, audience and engagement stats, creator and brand account search, and profile search for TikTok, Instagram and Threads.

On MCP, `tools/list` is free and `tools/call` is paid. The same service is reachable over plain HTTP with an OpenAPI 3.1 spec and over A2A, and a TypeScript client is published.

## Features

- **Cross-platform mentions:** Aggregate mentions and sentiment across platforms.
- **Per-platform routes:** Search, profiles, feeds and comments for X, Reddit, TikTok, Bluesky, Hacker News and more.
- **YouTube transcripts:** Fetch a video's transcript or its comments.
- **Meta Ad Library:** Search ads through a facebook_ads tool.
- **Account discovery:** Find creator and brand accounts and read audience stats.
- **One schema:** Results from different platforms share a single JSON structure.

## Good for

- Track brand mentions across Reddit, X and TikTok
- Read a Hacker News thread for sentiment
- Pull a YouTube transcript for summarising
- Check competitors' ads in the Meta Ad Library
- Find creator accounts in a niche

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http social-media-data https://social.duoleads.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://social.duoleads.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "social-media-data": {
      "url": "https://social.duoleads.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "social-media-data": {
      "type": "http",
      "url": "https://social.duoleads.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "social-media-data": {
      "serverUrl": "https://social.duoleads.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "social-media-data": {
      "type": "http",
      "url": "https://social.duoleads.com/mcp"
    }
  }
}
```

## Tools

- `bluesky_search`: Bluesky post search.
- `bluesky_posts`: Bluesky account feed.
- `bluesky_profile`: Bluesky profile.
- `hackernews_search`: Hacker News search.
- `hackernews_thread`: Hacker News thread.
- `social_mentions`: Social mentions and aggregate sentiment.
- `x_search`: X post search.
- `x_posts`: X user timeline.
- `x_profile`: X profile.
- `reddit_search`: Reddit post search.
- `reddit_comments`: Reddit post comments.
- `tiktok_videos`: TikTok account videos.
- `tiktok_search`: TikTok video search.
- `instagram_profile`: Instagram profile and posts.
- `youtube_transcript`: YouTube transcript.
- `youtube_comments`: YouTube video comments.
- `threads_posts`: Threads account posts.
- `facebook_ads`: Meta Ad Library search.
- `social_search`: Search on X, Reddit and TikTok.
- `social_audience`: Audience and engagement stats.
- `social_accounts`: Creator and brand account search.
- `linkedin_company`: LinkedIn company page.
- `people_search`: Profile search on TikTok, Instagram and Threads.
- `tiktok_followers`: TikTok followers list.
- `tiktok_following`: TikTok following list.
- `linkedin_profile`: LinkedIn profile.

## FAQ

### How much does a call cost?

$0.01 to $0.025 depending on the route, paid in USDC on Base.

### Do I need an API key?

No. There is no account or key; payment is per request via x402.

### Which calls are free?

tools/list is free, and bad input, no match and total upstream failures are not charged.

### Is a partial result billed?

Yes. A 200 response with complete: false is charged.

### Is Social Media Data API free?

No. Social Media Data API is a paid product.

### How do I add Social Media Data API to Claude Code?

Run this command in your terminal: claude mcp add --transport http social-media-data https://social.duoleads.com/mcp

### What are the best alternatives to Social Media Data API?

The closest alternatives to Social Media Data API are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/social-media-data-api
