GETlists

Search Within Twitter Lists

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

Average response time: 100ms

Code Examples

const response = await fetch(
  'https://scrapebadger.com/v1/twitter/lists/1234567/search_tweets?query=AI',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const results = await response.json();
results.data.forEach(t => console.log(t.text));
Response
{
  "data": [
    { "id": "ls_001", "text": "New AI model achieves SOTA on...", "favorite_count": 450 }
  ],
  "next_cursor": "list_search_cursor"
}

API Reference

GET/v1/twitter/lists/{list_id}/search_tweets
ParameterTypeRequiredDescription
list_idstringRequiredThe numeric Twitter list ID
querystringRequiredSearch query to filter list tweets
cursorstringOptionalPagination cursor for next page

Use Cases

Social Listening

Monitor brand mentions, keywords, and conversations across Twitter in real time to understand public sentiment and emerging topics.

Content Curation

Aggregate top-performing content by topic or industry to fuel newsletters, social feeds, and content marketing calendars.

Market Research

Analyze consumer conversations, product feedback, and market trends to inform product development and go-to-market strategies.

Trend Tracking

Detect emerging trends, viral content, and breaking news before they peak using real-time trending topic data.

Competitor Analysis

Track competitor accounts, engagement rates, and content strategies to benchmark performance and identify opportunities.

Academic Research

Collect large-scale Twitter datasets for computational social science, NLP research, political analysis, and network studies.

Frequently Asked Questions

The query supports basic keyword matching within the list's tweet timeline.

Yes. This searches only within tweets from list members, giving you a focused, curated result set.

Great for monitoring niche topics within curated groups — e.g., searching for "funding" in a VC list.

Yes. Use list search to find relevant tweets, then use tweet-level endpoints for deeper analysis.