SocialData.Tools: API Documentation
  • Getting Started
  • Authentication
  • Pricing
  • SDKs and Code Examples
  • Twitter: Tweets
    • Retrieve tweet details
    • Retrieve thread
    • Retrieve article details
    • Retrieve all users who retweeted a tweet
    • Retrieve search results by keyword
    • Retrieve all users who liked a tweet
  • Twitter: Users
    • Retrieve user profile details
    • Retrieve profile's affiliated users
    • Retrieve tweets and replies made by a specific user
    • Retrieve likes made by a specific user
    • Retrieve user's articles
    • Retrieve user's highlighted tweets
    • Retrieve user's followers
    • Retrieve user's following
    • Retrieve user's lists
    • Check if a user is following another user
    • Check if a user retweeted a specific tweet
    • Check if a user commented on a specific tweet
    • Check if a user liked a specific tweet
    • Retrieve users search results by screenname
  • Twitter: Lists
    • Retrieve list details
    • Retrieve list members
  • Twitter: Spaces
    • Retrieve Twitter spaces stream details
  • Twitter / X: Communities
    • Retrieve community tweets timeline
    • Retrieve community members
  • Twitter / X: Async Endpoints
    • Introduction
    • Getting job status
    • Using Webhooks
    • Retrieve large number of search results
    • Retrieve all comments for any tweet
Powered by GitBook
On this page
  • Pricing per Endpoint
  • Fair-use Policy

Pricing

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

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

Data Type
Endpoints
Rate

User Profile

GET /twitter/user/[user_id]

GET /twitter/user/[user_id]/affiliates

GET /twitter/user/[user_id]/articles GET /twitter/user/[username] GET /twitter/list/members GET /twitter/tweets/[tweet_id]/liking_users GET /twitter/tweets/[tweet_id]/retweeted_by GET /twitter/followers/list

GET /twitter/friends/list

$0.0002 per each user object returned in response

Tweet

GET /twitter/statuses/show

GET /twitter/thread/[id]

GET /twitter/tweets/[tweet_id]

GET /twitter/article/[article_id]

GET /twitter/search GET /twitter/user/[user_id]/tweets GET /twitter/user/[user_id]/tweets-and-replies GET /twitter/user/[user_id]/likes

GET /twitter/user/[user_id]/highlights

$0.0002 per each tweet returned in response

Space

GET /twitter/spaces/show

$0.0002 per each follower or friend returned in response

Lists

GET /twitter/lists/show GET /twitter/user/[user_id]/lists

$0.0002 per each list object

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

PreviousAuthenticationNextSDKs and Code Examples

Last updated 10 months ago