# SocialData pricing

Machine-readable pricing for the SocialData API (https://api.socialdata.tools).
Canonical source: https://docs.socialdata.tools/getting-started/pricing/
Monitoring rates: https://docs.socialdata.tools/monitoring/pricing/

## Model

- Pay as you go from a prepaid balance. No subscription, no monthly commitment, no minimum.
- Most endpoints cost **$0.0002 per item returned** ($0.20 per 1,000 items).
- Billing counts items, not requests. A response holding 20 tweets costs 20 x $0.0002 = $0.0040.
- A request that returns no data is free, but only for the first 3 such requests per minute. After that each one costs $0.0002.
- A failed request costs nothing.
- An empty balance returns `HTTP 402 Payment Required`.
- Prices are in USD.

## Data API

| Endpoint | Method and path | Price |
| --- | --- | --- |
| Get search results | `GET /twitter/search` | $0.0002 per tweet |
| Get user profile | `GET /twitter/user/{username_or_id}` | $0.0002 per request |
| Get user profiles by IDs | `POST /twitter/users-by-ids` | $0.0002 per profile |
| Get user profiles by usernames | `POST /twitter/users-by-usernames` | $0.0002 per profile |
| Get user followers | `GET /twitter/user/{user_id}/followers` | $0.0002 per follower |
| Get user verified followers | `GET /twitter/user/{user_id}/verified-followers` | $0.0002 per follower |
| Get user following | `GET /twitter/user/{user_id}/following` | $0.0002 per followed user |
| Get user tweets and replies | `GET /twitter/user/{user_id}/tweets`, `GET /twitter/user/{user_id}/tweets-and-replies` | $0.0002 per tweet |
| Get user mentions | `GET /twitter/user/{username}/mentions` | $0.0002 per mention |
| Get user highlights | `GET /twitter/user/{user_id}/highlights` | $0.0002 per tweet |
| Get user affiliates | `GET /twitter/user/{user_id}/affiliates` | $0.0002 per affiliated user |
| Get user lists | `GET /twitter/user/{user_id}/lists` | $0.0002 per list |
| Get user extended bio | `GET /twitter/user/{username}/extended-bio` | $0.001 per request |
| Get similar profiles | `GET /twitter/user/{user_id}/similar` | $0.0002 per similar user |
| Get tweet | `GET /twitter/tweets/{id}` | $0.0002 per request |
| Get multiple tweets by IDs | `POST /twitter/tweets-by-ids` | $0.0002 per tweet |
| Get tweet comments | `GET /twitter/tweets/{id}/comments` | $0.0002 per comment |
| Get tweet quotes | `GET /twitter/tweets/{id}/quotes` | $0.0002 per quote-tweet |
| Get tweet retweeters | `GET /twitter/tweets/{tweet_id}/retweeted_by` | $0.0002 per user profile |
| Get thread | `GET /twitter/thread/{thread_id}` | $0.0002 per tweet |
| Get article details | `GET /twitter/article/{article_id}` | $0.0002 per request |
| Get article v2 | `GET /v2/twitter/article/{article_id}` | $0.0002 per request |
| Get list details | `GET /twitter/list/{list_id}` | $0.0002 per request |
| Get list members | `GET /twitter/list/{list_id}/members` | $0.0002 per list member |
| Get list tweets | `GET /twitter/list/{list_id}/tweets` | $0.0002 per tweet |
| Get community details | `GET /twitter/community/{community_id}` | $0.0002 per request |
| Get community tweets | `GET /twitter/community/{community_id}/tweets` | $0.0002 per tweet |
| Get community members | `GET /twitter/community/{community_id}/members` | $0.0002 per member |
| Search community tweets | `GET /twitter/community/{community_id}/search` | $0.0002 per tweet |
| Get Space details | `GET /twitter/space/{space_id}` | $0.0002 per request |

## Social Actions API

Single-call checks. Each one replaces paging through a full list, and costs less than doing so.

| Endpoint | Method and path | Price |
| --- | --- | --- |
| Verify user is following | `GET /twitter/user/{source_user_id}/following/{target_user_id}` | $0.004 per request |
| Verify user retweeted | `GET /twitter/tweets/{tweet_id}/retweeted_by/{user_id}` | $0.008 per request |
| Verify user commented | `GET /twitter/tweets/{tweet_id}/commented_by/{user_id}` | $0.008 per request |

## Monitoring API

User monitors (tweets, following, profile) cost a flat hourly rate. The volume of events makes no difference. The first hour is charged when you create the monitor, and every following hour at the start of the hour. The rate drops automatically with the number of active monitors you hold.

| Active monitors | Hourly rate per monitor | Approximate monthly rate |
| --- | --- | --- |
| 1 - 10 | $0.0069 | ~$4.99 |
| 11 - 100 | $0.0062 | ~$4.49 |
| 101 - 300 | $0.0055 | ~$3.99 |
| 301 - 500 | $0.0048 | ~$3.49 |
| 501 - 1000 | $0.0042 | ~$2.99 |
| 1000+ | $0.0035 | ~$2.49 |

Search query monitors cost per execution instead. Creating one is free, and there is no hourly fee.

- $0.0002 per tweet delivered.
- $0.0002 flat for an execution that delivers nothing, because the search still runs.

The `refresh_frequency` drives the bill, not how active the query is:

| refresh_frequency | Executions per day | Minimum per day | Minimum per month |
| --- | --- | --- | --- |
| 30 seconds (default) | 2,880 | $0.58 | ~$17.28 |
| 60 seconds | 1,440 | $0.29 | ~$8.64 |
| 300 seconds | 288 | $0.06 | ~$1.73 |
| 3600 seconds | 24 | $0.005 | ~$0.14 |

Delivered tweets cost $0.0002 each on top of those minimums. Pick the slowest frequency your use case tolerates.

A monitor is paused, not deleted, when the balance cannot cover a charge. Topping up resumes it.

## MCP server

The MCP server at `https://api.socialdata.tools/mcp` is a different way to reach the same endpoints. Every tool call costs exactly the same as the equivalent REST call. Connecting a client costs nothing. `get_user_followers` and `get_user_following` bill for a full page of user records per call, so use `check_is_following` when the question is only whether one account follows another.

## Rate limits

120 requests per minute per API key, shared across all endpoints. Write to support@socialdata.tools for a higher limit at no extra charge.

## Related

- Pricing page: https://docs.socialdata.tools/getting-started/pricing/
- Monitoring pricing: https://docs.socialdata.tools/monitoring/pricing/
- Agent guide: https://socialdata.tools/llms.txt
- OpenAPI spec: https://socialdata.tools/openapi.yaml