Skip to content

Tweet

GET/v1/twitter/tweet1 credit

Returns a single post: full text, entities, media, like, reply, repost, quote, bookmark and view counts, and its author.

01Query parameters

NameTypeDescription
urlrequiredstringThe post's URL on x.com or twitter.com, e.g. `https://x.com/NASA/status/2110491624337760703`.
trimoptionalboolean`true` returns only `rest_id`, `views` and `legacy`.Default: false
cache_max_ageoptionalstringAccepted for compatibility; every call is fetched fresh and costs the normal price. Any other value is a free 400.Accepted values:1d3d7d14d30d

02Request

curl "https://api.scrapesocial.ai/v1/twitter/tweet?url=https%3A%2F%2Fx.com%2FNASA%2Fstatus%2F2110491624337760703" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/twitter/tweet?url=https%3A%2F%2Fx.com%2FNASA%2Fstatus%2F2110491624337760703

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "__typename": "Tweet",
  "content_disclosure": {
    "ai_generated_disclosure": {
      "can_edit": true,
      "has_ai_generated_media": false
    }
  },
  "core": {
    "user_results": {
      "result": {
        "__typename": "User",
        "affiliates_highlighted_label": {},
        "avatar": {
          "image_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
        },
        "core": {
          "created_at": "Wed Dec 19 20:20:32 +0000 2007",
          "name": "NASA",
          "screen_name": "NASA"
        },
        "dm_permissions": {
          "can_dm": false
        },
        "follow_request_sent": false,
        "has_graduated_access": true,
        "id": "VXNlcjoxMTM0ODI4Mg==",
        "is_blue_verified": true,
        "legacy": {
          "default_profile": false,
          "default_profile_image": false,
          "description": "Making the seemingly impossible, possible. ✨",
          "entities": {
            "description": {},
            "url": {
              "urls": [
                {
                  "display_url": "nasa.gov",
                  "expanded_url": "http://www.nasa.gov/",
                  "indices": [
                    0,
                    23
                  ],
                  "url": "https://t.co/9NkQJKAnuU"
                }
              ]
            }
          },
          "fast_followers_count": 0,
          "favourites_count": 17049,
          "follow_request_sent": false,
          "followers_count": 92312406,
          "friends_count": 115,
          "has_custom_timelines": true,
          "is_translator": false,
          "listed_count": 96844,
          "media_count": 28207,
          "needs_phone_verification": false,
          "normal_followers_count": 92312406,
          "notifications": false,
          "pinned_tweet_ids_str": [
            "2113776971603689874"
          ],
          "possibly_sensitive": false,
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
          "profile_interstitial_type": "",
          "statuses_count": 74455,
          "time_zone": "",
          "translator_type": "regular",
          "url": "https://t.co/9NkQJKAnuU",
          "utc_offset": 0,
          "withheld_description": "",
          "withheld_scope": ""
        },
        "location": {
          "location": "Pale Blue Dot"
        },
        "media_permissions": {
          "can_media_tag": false
        },
        "parody_commentary_fan_label": "None",
        "privacy": {
          "protected": false
        },
        "profile_bio": {
          "description": "Making the seemingly impossible, possible. ✨"
        },
        "profile_description_language": "en",
        "profile_image_shape": "Square",
        "relationship_perspectives": {
          "blocked_by": false,
          "blocking": false,
          "followed_by": false,
          "following": false,
          "muting": false
        },
        "rest_id": "11348282",
        "super_follow_eligible": false,
        "super_followed_by": false,
        "super_following": false,
        "verification": {
          "verified": false,
          "verified_type": "Government"
        }
      }
    }
  },
  "edit_control": {
    "edit_tweet_ids": [
      "2110491624337760703"
    ],
    "editable_until_msecs": "1792018988000",
    "edits_remaining": "5",
    "is_edit_eligible": true
  },
  "grok_analysis_button": true,
  "grok_annotations": {
    "is_image_editable_by_grok": true
  },
  "is_translatable": false,
  "legacy": {
    "bookmark_count": 127,
    "bookmarked": false,
    "conversation_id_str": "2110491624337760703",
    "created_at": "Wed Oct 14 22:03:08 +0000 2026",
    "display_text_range": [
      0,
      196
    ],
    "entities": {
      "media": [
        {
          "display_url": "pic.x.com/zVlEbx7Qf1",
          "expanded_url": "https://x.com/NASA/status/2110491624337760703/photo/1",
          "ext_alt_text": "An astronaut on a spacewalk outside the International Space Station raises their arm in the direction of the camera. Equipment and hardware surround them.",
          "ext_media_availability": {
            "status": "Available"
          },
          "features": {
            "large": {
              "faces": []
            },
            "medium": {
              "faces": []
            },
            "orig": {
              "faces": []
            },
            "small": {
              "faces": []
            }
          },
          "id_str": "2110491621426917377",
          "indices": [
            197,
            220
          ],
          "media_key": "3_2110491621426917377",
          "media_results": {
            "result": {
              "media_key": "3_2110491621426917377"
            }
          },
          "media_url_https": "https://pbs.twimg.com/media/HUn48qSW8AEmiHh.jpg",
          "original_info": {
            "focus_rects": [
              {
                "h": 1075,
                "w": 1920,
                "x": 0,
                "y": 0
              },
              {
                "h": 1280,
                "w": 1280,
                "x": 272,
                "y": 0
              }
            ],
            "height": 1280,
            "width": 1920
          },
          "sizes": {
            "large": {
              "h": 1280,
              "resize": "fit",
              "w": 1920
            },
            "medium": {
              "h": 800,
              "resize": "fit",
              "w": 1200
            },
            "small": {
              "h": 453,
              "resize": "fit",
              "w": 680
            },
            "thumb": {
              "h": 150,
              "resize": "crop",
              "w": 150
            }
          },
          "type": "photo",
          "url": "https://t.co/zVlEbx7Qf1"
        }
      ],
      "urls": [
        {
          "display_url": "go.nasa.gov/4i6Xa9I",
          "expanded_url": "https://go.nasa.gov/4i6Xa9I",
          "indices": [
            173,
            196
          ],
          "url": "https://t.co/uNgY1GXU8o"
        }
      ],
      "user_mentions": [
        {
          "id_str": "1451773004",
          "indices": [
            146,
            160
          ],
          "name": "International Space Station",
          "screen_name": "Space_Station"
        }
      ]
    },
    "extended_entities": {
      "media": [
        {
          "display_url": "pic.x.com/zVlEbx7Qf1",
          "expanded_url": "https://x.com/NASA/status/2110491624337760703/photo/1",
          "ext_alt_text": "An astronaut on a spacewalk outside the International Space Station raises their arm in the direction of the camera. Equipment and hardware surround them.",
          "ext_media_availability": {
            "status": "Available"
          },
          "features": {
            "large": {
              "faces": []
            },
            "medium": {
              "faces": []
            },
            "orig": {
              "faces": []
            },
            "small": {
              "faces": []
            }
          },
          "id_str": "2110491621426917377",
          "indices": [
            197,
            220
          ],
          "media_key": "3_2110491621426917377",
          "media_results": {
            "result": {
              "media_key": "3_2110491621426917377"
            }
          },
          "media_url_https": "https://pbs.twimg.com/media/HUn48qSW8AEmiHh.jpg",
          "original_info": {
            "focus_rects": [
              {
                "h": 1075,
                "w": 1920,
                "x": 0,
                "y": 0
              },
              {
                "h": 1280,
                "w": 1280,
                "x": 272,
                "y": 0
              }
            ],
            "height": 1280,
            "width": 1920
          },
          "sizes": {
            "large": {
              "h": 1280,
              "resize": "fit",
              "w": 1920
            },
            "medium": {
              "h": 800,
              "resize": "fit",
              "w": 1200
            },
            "small": {
              "h": 453,
              "resize": "fit",
              "w": 680
            },
            "thumb": {
              "h": 150,
              "resize": "crop",
              "w": 150
            }
          },
          "type": "photo",
          "url": "https://t.co/zVlEbx7Qf1"
        }
      ]
    },
    "favorite_count": 2691,
    "favorited": false,
    "full_text": "There's work to be done 🛠️\n\nJoin us on Oct. 20 for a preview of two upcoming spacewalks in which astronauts will install solar arrays to give the @Space_Station more power: https://t.co/uNgY1GXU8o https://t.co/zVlEbx7Qf1",
    "id_str": "2110491624337760703",
    "is_quote_status": false,
    "lang": "en",
    "possibly_sensitive": false,
    "possibly_sensitive_editable": true,
    "quote_count": 725,
    "reply_count": 178,
    "retweet_count": 390,
    "retweeted": false,
    "user_id_str": "11348282"
  },
  "rest_id": "2110491624337760703",
  "unmention_data": {},
  "views": {
    "count": "944692",
    "state": "EnabledWithCount"
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

An unknown or deleted post is a free 404 (`Tweet not found`). A URL without a numeric status id is a free 400 (`Tweet ID is not a number`).

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

  • 400missing_parameter

    A required parameter is missing or invalid.

  • 403private_account

    The account is private or age-restricted.

  • 404not_found

    No such account.

  • 503upstream_error

    The platform did not answer; retry shortly.