# Pricing

{% hint style="danger" %} <mark style="color:red;">**WARNING:**</mark>&#x20;

**You are viewing an outdated version of our documentation.** \
**For the latest and most accurate information, please visit** [**docs.socialdata.tools**](https://docs.socialdata.tools)**.**
{% endhint %}

SocialData API follows a usage-based pricing system, where the exact amount charged against your balance is determined by the amount of data you retrieve.

To access the API, users need to maintain a positive balance in their account, otherwise their request will be rejected with HTTP 402 Payment Required status code.

Each *successful* request made to our API consumes a certain amount from your balance. The exact charge per request varies depending on the specific API endpoint and the amount of data returned (e.g. if an endpoint returns 20 tweets in one response, each of these tweets will be charged).&#x20;

On rare occasions our system will fail to retrieve any data from X. Failed requests do not consume any balance, ensuring fair and accurate billing.

## Pricing per Endpoint

<table><thead><tr><th width="154">Data Type</th><th width="417">Endpoints</th><th>Rate</th></tr></thead><tbody><tr><td><strong>User Profile</strong></td><td><p>GET /twitter/user/[user_id]</p><p>GET /twitter/user/[user_id]/affiliates</p><p>GET /twitter/user/[user_id]/articles<br>GET /twitter/user/[username]<br>GET /twitter/list/members<br>GET /twitter/tweets/[tweet_id]/liking_users<br>GET /twitter/tweets/[tweet_id]/retweeted_by<br>GET /twitter/followers/list</p><p>GET /twitter/friends/list</p></td><td><strong>$0.0002</strong> per each user object returned in response</td></tr><tr><td><strong>Tweet</strong></td><td><p>GET /twitter/statuses/show</p><p>GET /twitter/thread/[id]</p><p>GET /twitter/tweets/[tweet_id]</p><p>GET /twitter/article/[article_id]</p><p>GET /twitter/search<br>GET /twitter/user/[user_id]/tweets<br>GET /twitter/user/[user_id]/tweets-and-replies<br>GET /twitter/user/[user_id]/likes</p><p>GET /twitter/user/[user_id]/highlights</p></td><td><strong>$0.0002</strong> per each tweet returned in response</td></tr><tr><td><strong>Space</strong></td><td>GET /twitter/spaces/show</td><td><strong>$0.0002</strong> per each follower or friend returned in response</td></tr><tr><td><strong>Lists</strong></td><td>GET /twitter/lists/show<br>GET /twitter/user/[user_id]/lists</td><td><strong>$0.0002</strong> per each list object</td></tr></tbody></table>

## Fair-use Policy

By default, requests that do not return any data are not charged against your account. However, please note that even though these requests are not billed, they still impose a burden on the platform and generate costs.

To provide a certain level of free usage, every account is entitled to make up to 3 requests per minute without incurring any charges. Any requests made beyond the initial 3 free requests per minute will be treated as billable request and assumed to return a single item of data (e.g. tweet, user, list or space).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://socialdata.gitbook.io/docs/pricing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.