Twitter Tweet Retweets API

Endpoint

GET /v1/twitter/tweet/retweets

Parameters

tweet_id *

Numeric tweet ID

pages

Number of pages to fetch, 1-10 (default: 1)

Response fields

retweets

Array of user profiles who retweeted

username

Twitter username

name

Display name

user_id

Twitter user ID

description

Bio / profile description

followers_count

Number of followers

following_count

Number of accounts followed

tweet_count

Total tweets posted

verified

Whether verified

profile_image_url

URL to profile image

created_at

Account creation date

url

Link to their profile

tweet_id

Requested tweet ID

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/twitter/tweet/retweets?tweet_id=1631781099415257088&pages=1" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/twitter/tweet/retweets",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"tweet_id": "1631781099415257088", "pages": 1}
)
print(response.json())

Example Response

{
  "retweets": [
    {
      "username": "user123",
      "name": "Example User",
      "user_id": "123456789",
      "description": "Retweeted this!",
      "followers_count": 1000,
      "following_count": 500,
      "tweet_count": 3000,
      "verified": false,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "created_at": "2019-05-20 08:15:00",
      "url": "https://twitter.com/user123"
    }
  ],
  "tweet_id": "1631781099415257088",
  "pages": 1,
  "count": 20
}

Frequently asked questions

How many retweeters are returned per page?

Each page returns approximately 20 user profiles. You can fetch up to 10 pages (200 users) in a single call.

Does this include quote tweets?

No, this only returns users who retweeted (shared without commentary). Use the Tweet Quotes endpoint for quote tweets.

How does pricing work?

You only pay for successful requests. The Twitter Tweet Retweets API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.