Reddit Scraper API just launched: posts, comments, subreddits, users & full search→
Twitter Scraper APIsLists API
Twitter Lists API

Twitter (X) Lists Details API for Complete List Metadata and Curated Tweet Data

Retrieve public Twitter List details, fetch tweets from a List timeline, and search for matching posts inside a specific List as structured JSON.

3 List-specific endpoints
1 base credit + 1 credit per item returned
Failed requests cost 0 credits
1,000 free credits
No credit card required
Get Started FreeView Docs
GET /v1/twitter/lists/{list_id}/detail
TWITTER
{
  "data": {
    "id": "1234567",
    "name": "AI Researchers",
    "description": "Top AI researchers and practitioners",
    "member_count": 245,
    "subscriber_count": 1200,
    "creator": { "username": "curator", "followers_count": 15000 }
  }
}
Endpoints

3 Lists Endpoints

All endpoints return structured JSON and authenticate with your API key in the x-api-key header.

GETGet List Detail

Get complete metadata for any Twitter list: name, description, member count, subscriber count, creation date, and creator profile.

/v1/twitter/lists/{list_id}/detail
GETGet List Tweets

Get all tweets from any Twitter list timeline. Lists are curated feeds, perfect for monitoring specific topics, industries, or groups of accounts.

/v1/twitter/lists/{list_id}/tweets
GETSearch List Tweets

Search for specific keywords within a Twitter list's timeline. Combine the curation of lists with the precision of search.

/v1/twitter/lists/{list_id}/search_tweets
Cost Calculator

Estimate your lists scraping cost

Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Total credits for 1,000 lists requests21,000
Loading plans…
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. No hidden fees, no lock-in.

See full pricing details
FAQ

Frequently asked questions

Everything you need to know about the Twitter Lists API.

What is a Twitter Lists Details API?

A Twitter Lists Details API turns public Twitter List metadata and List-based posts into structured data an application can use. ScrapeBadger's three Lists endpoints retrieve a List's details, return tweets from its timeline, and search for matching tweets within that List.

What Twitter List data can I retrieve?

The Get List Details response can include the List ID, name, description, creation timestamp, member count, subscriber count, public or private visibility mode, owner user ID, and owner username when available.

How do I find the list_id required by the API?

Use the List's unique numeric ID from its Twitter URL or from data already stored in your application. Pass that value as the list_id path parameter in each of the three Lists endpoints.

Can I retrieve and search tweets from a specific Twitter List?

Yes. Get List Tweets returns posts from the List timeline, while Search List Tweets requires a query and returns posts inside that List that match it. Both return detailed tweet objects and support cursor-based pagination.

How does pagination work for List tweets?

Get List Tweets and Search List Tweets return next_cursor when another page is available. Pass that value as the cursor parameter in the next request and continue until next_cursor is null or absent. Get List Details returns a single metadata object and does not require pagination.

How much does the Twitter Lists API cost?

Every successful Lists request costs 1 base credit plus 1 credit for each item returned. A List-details lookup returns one object and uses 2 credits. A page containing 20 tweets uses 21 credits. A search returning 50 matching tweets uses 51 credits. Failed 4xx and 5xx requests use 0 credits, and the exact charge is returned in the X-Credits-Used response header.

Does the Twitter Lists API have rate limits?

Yes. Request-per-minute limits depend on the selected ScrapeBadger plan. See the pricing table for the current limits per plan tier.

More Twitter Data APIs

Tweets APIAdvanced Tweet Search APICommunities APITrends APIGeo APILive Events APIUsers APITwitter StreamsAll Twitter APIs

Start building with the Lists API

Sign up free and get 1,000 API credits. No credit card required.

Start Free TrialView All Twitter APIs

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with X Corp. (formerly Twitter, Inc.) or any of its subsidiaries or affiliates. The names Twitter, X, and related trademarks are the property of their respective owners.