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