Twitter Tweet Comments API

Endpoint

GET /v1/twitter/tweet/comments

Parameters

tweet_id *

Numeric tweet ID

pages

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

Response fields

comments

Array of reply tweets

title

Tweet title (format: @username on X)

url

Direct link to the reply

date

Publication date and time

author

Twitter username of the commenter

source

Platform name (Twitter (X))

domain

x.com

snippet

Reply content text

likes

Number of likes

retweets

Number of retweets

replies

Number of replies to this comment

quotes

Number of quote tweets

bookmarks

Number of bookmarks

views

Number of views (null when unavailable)

author_followers

Commenter's follower count

author_verified

Whether the commenter is verified

lang

Tweet language code

is_reply

Always true for this endpoint

is_quote

Whether the reply is also a quote

hashtags

Hashtags used

user_mentions

Usernames mentioned

tweet_id

Requested tweet ID

pages

Number of pages fetched

count

Total results returned

Example Request

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

import requests

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

Example Response

{
  "comments": [
    {
      "title": "@commenter on X",
      "url": "https://twitter.com/commenter/status/...",
      "date": "2024-01-15 15:00:00",
      "author": "commenter",
      "source": "Twitter (X)",
      "domain": "x.com",
      "snippet": "@username Great post! Totally agree.",
      "likes": 50,
      "retweets": 5,
      "replies": 2,
      "quotes": 0,
      "bookmarks": 3,
      "views": 5000,
      "author_followers": 2500,
      "author_verified": false,
      "lang": "en",
      "is_reply": true,
      "is_quote": false,
      "hashtags": [],
      "user_mentions": ["username"]
    }
  ],
  "tweet_id": "1631781099415257088",
  "pages": 1,
  "count": 20
}

Frequently asked questions

How are comments sorted?

Comments are returned sorted by relevance (most engaged replies first).

How many comments are returned per page?

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

How does pricing work?

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