🐦 Twitter Communities Search Scraper

This actor allows you to search for Twitter communities by keyword or phrase. It uses the latest Twitter API interface and supports automatic pagination to collect up to the number of communities you specify.

Features

• Search for Twitter communities by keyword or phrase.
• Supports automatic pagination to retrieve large lists.
• Allows you to specify the maximum number of results (maxResults).
• Returns detailed information for each community.

Input

• query (string, required): The keyword or phrase to search for Twitter communities.
• maxResults (integer, optional): Maximum number of communities to fetch. Default is 7.

Output

The output is an array of community objects, each containing:

• community_id
• member_count
• name
• primary_topic
• is_nsfw
• custom_banner
• default_banner
• user_id

Example Input

{
  "query": "AI",
  "maxResults": 10
}

Example Output

[
	{
		"community_id": "1601841656147345410",
		"member_count": 202186,
		"name": "Generative AI",
		"primary_topic": "Artificial Intelligence",
		"is_nsfw": false,
		"custom_banner": "https://pbs.twimg.com/community_banner_img/1926641081623384064/EM7s0mV4?format=jpg&name=orig",
		"default_banner": "https://pbs.twimg.com/media/FECQBhUVIAAmMdc.jpg",
		"user_id": "",
		"scrapedAt": "2025-05-30T03:46:09.234Z"
	},
	...
]

Notes

• The actor will stop fetching once it reaches the specified maxResults or there are no more communities to fetch.
• Make sure your search query complies with Twitter's search policies.