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
Powered by GitBook
On this page
  • Endpoint
  • Endpoint parameters
  • Response codes
  • Rate limits
  • Example request
  • Example response
  1. Twitter: Tweets

Retrieve tweet details

PreviousSDKs and Code ExamplesNextRetrieve thread

Last updated 22 days ago

WARNING:

You are viewing an outdated version of our documentation. For the latest and most accurate information, please visit .

Endpoint

GET https://api.socialdata.tools/twitter/statuses/show?id=...
  or
GET https://api.socialdata.tools/twitter/tweets/[id]

Endpoint parameters

Name
Description
Example

id (Required)

The numerical ID of the desired Tweet.

1729591119699124560

Common Issues and Best Practices

  • In languages where the id value exceeds the default Integer type limit (e.g., Node.js), store id as a string. Use the id_str property returned by the API for these values

Response codes

  • HTTP 200 OK - succeeded

  • HTTP 402 Payment Required - not enough credits to perform this request

  • HTTP 404 Not Found - requested tweet does not exist

  • HTTP 422 Unprocessable Content - validation failed (e.g. one of the required parameters was not provided)

  • HTTP 500 Internal Server Error - other error, typically means that SocialData API failed to obtain the requested information and you should try again later

Rate limits

By default each user has a limit of 120 requests per minute shared across all endpoints. Please reach out to support@socialdata.tools if you need to raise your rate limit.

Example request

curl "https://api.socialdata.tools/twitter/statuses/show?id=1729591119699124560"
-H 'Authorization: Bearer API_KEY'
-H 'Accept: application/json

Example response

// If succeeded: 
{
    "tweet_created_at": "2023-11-28T20:00:31.000000Z",
    "id": 1729591119699124560,
    "id_str": "1729591119699124560",
    "text": null,
    "full_text": "Cybertruck deliveries start on Thursday",
    "source": "<a href=\"http:\\/\\/twitter.com\\/download\\/iphone\" rel=\"nofollow\">Twitter for iPhone<\\/a>",
    "truncated": false,
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user": {
        "id": 44196397,
        "id_str": "44196397",
        "name": "Elon Musk",
        "screen_name": "elonmusk",
        "location": "\\ud835\\udd4f\\u00d0",
        "url": null,
        "description": "",
        "protected": false,
        "verified": false,
        "followers_count": 166212541,
        "friends_count": 506,
        "listed_count": 149575,
        "favourites_count": 37987,
        "statuses_count": 34934,
        "created_at": "2009-06-02T20:12:29.000000Z",
        "profile_banner_url": "https:\\/\\/pbs.twimg.com\\/profile_banners\\/44196397\\/1690621312",
        "profile_image_url_https": "https:\\/\\/pbs.twimg.com\\/profile_images\\/1683325380441128960\\/yRsRRjGO_normal.jpg",
        "can_dm": false
    },
    "quoted_status_id": null,
    "quoted_status_id_str": null,
    "is_quote_status": false,
    "quoted_status": null,
    "retweeted_status": null,
    "quote_count": 2401,
    "reply_count": 27681,
    "retweet_count": 17203,
    "favorite_count": 174519,
    "lang": "en",
    "entities": {
        "user_mentions": [],
        "urls": [],
        "hashtags": [],
        "symbols": []
    },
    "views_count": 37826996,
    "bookmark_count": 1321
}

// If failed:
{
    "status":"error",
    "message":"Tweet not found"
}

docs.socialdata.tools