v1
latestOpenAPI 3.1.02026-07-26180242448.0 KBLists
Search list tweets
Search for tweets within a specific Twitter list. Returns tweets from the list that match the given search query. Useful for finding specific content within curated tweet collections.
get/v1/twitter/lists/{list_id}/search_tweets
Path parameters
list_idstring required
Example:1580582120482430976
The unique numeric ID of the list.
Query parameters
querystring required
Example:artificial intelligence
Search query to filter tweets within the list.
cursorstring
Pagination cursor for fetching the next page of results.
Response
Successfully retrieved search results.
Example response
{
"data": [
{
"id": "1234567890123456789",
"text": "Hello, world! This is a tweet.",
"created_at": "Wed Oct 10 20:19:24 +0000 2018",
"lang": "en",
"user_id": "44196397",
"username": "elonmusk",
"user_name": "Elon Musk",
"hashtags": [
{
"text": "AI"
}
],
"place": {
"full_name": "San Francisco, CA",
"name": "San Francisco",
"country": "United States",
"country_code": "US"
},
"source": "Twitter Web App"
}
]
}