Get complete metadata for any Twitter list — name, description, member count, subscriber count, creation date, and creator profile.
Average response time: 70ms
const response = await fetch(
'https://scrapebadger.com/v1/twitter/lists/1234567/detail',
{ headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const list = await response.json();
console.log(list.data.name, list.data.member_count);{
"data": {
"id": "1234567",
"name": "AI Researchers",
"description": "Top AI researchers and practitioners",
"member_count": 245,
"subscriber_count": 1200,
"creator": { "username": "curator", "followers_count": 15000 }
}
}/v1/twitter/lists/{list_id}/detail| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Required | The numeric Twitter list ID |
Profile your audience by analyzing follower demographics, interests, activity patterns, and engagement behavior.
Track competitor accounts, engagement rates, and content strategies to benchmark performance and identify opportunities.
Aggregate top-performing content by topic or industry to fuel newsletters, social feeds, and content marketing calendars.
Identify and vet influencers by analyzing follower quality, engagement rates, audience demographics, and content authenticity.
Manage Twitter communities by tracking member activity, top contributors, discussion themes, and community health metrics.
Analyze consumer conversations, product feedback, and market trends to inform product development and go-to-market strategies.
No. Only public lists are accessible through the API.
List IDs appear in the URL when viewing a list on Twitter (e.g., twitter.com/i/lists/1234567).
No. This endpoint returns list metadata only. Use Get List Tweets to see content from the list.
Yes. Curated Twitter lists are excellent for segmenting audiences by topic, industry, or influence level.
Sign up for free and get 1,000 API credits instantly. No credit card required.