Twitter User Tweets API

Endpoint

GET /v1/twitter/user/tweets

Parameters

username *

Twitter username (without @, max 50 characters)

pages

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

Response fields

tweets

Array of tweets by the user

title

Tweet title (format: @username on X)

url

Direct link to the tweet

date

Publication date and time

author

Twitter username

source

Platform name (Twitter (X))

domain

x.com

snippet

Tweet content text

likes

Number of likes

retweets

Number of retweets

replies

Number of replies

quotes

Number of quote tweets

bookmarks

Number of bookmarks

views

Number of views (null when unavailable)

author_followers

Author's follower count

author_verified

Whether the author is verified

lang

Tweet language code

is_reply

Whether the tweet is a reply

is_quote

Whether the tweet is a quote tweet

hashtags

Hashtags used in the tweet

user_mentions

Usernames mentioned

username

Requested username

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/twitter/user/tweets?username=elonmusk&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/twitter/user/tweets",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"username": "elonmusk", "pages": 2}
)
print(response.json())

Example Response

{
  "tweets": [
    {
      "title": "@elonmusk on X",
      "url": "https://twitter.com/elonmusk/status/...",
      "date": "2024-03-01 18:30:00",
      "author": "elonmusk",
      "source": "Twitter (X)",
      "domain": "x.com",
      "snippet": "Tweet content here...",
      "likes": 50000,
      "retweets": 8000,
      "replies": 12000,
      "quotes": 3000,
      "bookmarks": 2000,
      "views": 5000000,
      "author_followers": 235918920,
      "author_verified": true,
      "lang": "en",
      "is_reply": false,
      "is_quote": false,
      "hashtags": [],
      "user_mentions": []
    }
  ],
  "username": "elonmusk",
  "pages": 2,
  "count": 40
}

Frequently asked questions

How many tweets are returned per page?

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

Does this include retweets?

Yes, the user's timeline includes original tweets, retweets, and quote tweets. Use the is_quote field to identify quote tweets.

What engagement data is included?

Each tweet includes likes, retweets, replies, quotes, bookmarks, and views. Views may be null for older tweets.

How does pricing work?

You only pay for successful requests. The Twitter User Tweets 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.