X Search

Get Retweeters of a Post

Retrieve the list of users who retweeted a specific post by its ID. Supports pagination via cursor.

Billing metadata: successful billable responses include the X-Desearch-Cost-Usd, X-Desearch-Usage-Count, X-Desearch-Service, and X-Desearch-Currency headers. JSON object responses also include optional cost_usd, usage_count, service, and currency fields. For example, usage_count=10 at $0.015 / 1,000 resolves to cost_usd=0.00015. JSON arrays, text, and streaming responses keep their body shape and expose billing metadata only through headers.

get/twitter/post/retweeters

Request

  • Base URL: https://api.desearch.ai
  • URL: https://api.desearch.ai/twitter/post/retweeters
  • Auth: API key in header Authorization

Query parameters

idstring required

The ID of the post to get retweeters for

cursorstring nullable

Cursor for pagination

Response

A JSON object containing the list of users who retweeted the post.

next_cursorstring nullable

Cursor for pagination

Example response

{
  "users": [
    {
      "id": "123456789",
      "url": "https://twitter.com/example_user",
      "name": "John Doe",
      "username": "johndoe",
      "created_at": "2023-01-01T00:00:00Z",
      "description": "This is an example user description.",
      "favourites_count": 100,
      "followers_count": 1500,
      "followings_count": 100,
      "listed_count": 10,
      "media_count": 50,
      "profile_image_url": "https://example.com/profile.jpg",
      "profile_banner_url": "https://example.com/banner.jpg",
      "statuses_count": 500,
      "verified": true,
      "is_blue_verified": true,
      "entities": {
        "description": {
          "urls": [
            {
              "display_url": "example.com",
              "expanded_url": "https://example.com/full-url",
              "url": "https://t.co/short",
              "indices": [
                50,
                73
              ]
            }
          ]
        },
        "url": {
          "urls": [
            {
              "display_url": "example.com",
              "expanded_url": "https://example.com/full-url",
              "url": "https://t.co/short",
              "indices": [
                50,
                73
              ]
            }
          ]
        }
      },
      "can_dm": true,
      "can_media_tag": true,
      "location": "Jamaica",
      "pinned_tweet_ids": [
        "123456789",
        "987654321"
      ],
      "professional": {
        "professional_type": "Business",
        "category": [
          {
            "id": 1,
            "name": "Technology"
          }
        ]
      },
      "affiliates_highlighted_label": {
        "label": {
          "badge": {
            "url": "https://pbs.twimg.com/profile_images/2005664281002491904/bz2ZO_nU_bigger.jpg"
          },
          "description": "Polymarket",
          "url": {
            "url": "https://twitter.com/Polymarket",
            "url_type": "DeepLink"
          },
          "user_label_display_type": "Badge",
          "user_label_type": "BusinessLabel"
        }
      },
      "website": "https://t.co/4sVzS0XYIW"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.