llms.txt Content
# SocialData API
> SocialData is a REST API and MCP server for X (formerly Twitter) data: tweets, search, user profiles, followers, lists, communities, Spaces, and webhook monitors. You need no X developer account, no proxies, and no HTML parsing. Billing is pay-as-you-go from a prepaid balance, at a flat rate per item returned. There are no subscription plans.
Base URL: `https://api.socialdata.tools`
Auth: `Authorization: Bearer YOUR_API_KEY` on every request. Get a key at https://socialdata.tools/app/api-keys
MCP endpoint: `https://api.socialdata.tools/mcp` (HTTP transport, same API key, read-only, 14 tools)
OpenAPI 3.0 spec: https://socialdata.tools/openapi.yaml (every endpoint, parameter, and response schema)
```bash
curl "https://api.socialdata.tools/twitter/search?query=from%3Aelonmusk&type=Latest" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"
```
```bash
claude mcp add --transport http socialdata https://api.socialdata.tools/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
```
Price (charged per item returned, not per request):
| What you fetch | Price |
| --- | --- |
| Tweets, profiles, followers, list and community items | $0.0002 each ($0.20 per 1,000) |
| Single-object lookups (one tweet, one list, one community, one Space, one profile) | $0.0002 per request |
| Extended bio | $0.001 per request |
| Social Actions: verify following | $0.004 per request |
| Social Actions: verify retweeted, verify commented | $0.008 per request |
Notes that agents get wrong:
- Rate limit: 120 requests per minute, shared across all endpoints, per API key. Write to support@socialdata.tools for a higher limit at no extra charge.
- Balance: the account must hold a positive balance. An empty balance returns `HTTP 402`.
- Billing: only successful requests that return data are billed. A request that returns nothing is free, but only for the first 3 such requests per minute; after that each one costs $0.0002.
- Pagination: cursor
OpenAPI Spec (preview)
openapi: 3.0.0
info:
title: SocialData API Reference
description: |-
SocialData API is a scalable and reliable API that simplifies the process of fetching data from Twitter/X. With SocialData API, you can easily retrieve tweets, user profiles, user followers/following and other information without the need for proxies or parsing Twitter responses.
termsOfService: https://socialdata.tools/legal/terms-and-conditions
contact:
email: support@socialdata.tools
version: 1.0.0
external