ScrapeBadger — Web Scraping Platform

ScrapeBadger provides REST APIs for three products. Use the web_fetch tool to call these endpoints.

Authentication

Every request needs the SCRAPEBADGER_API_KEY environment variable. Include it as an HTTP header: X-API-Key: $SCRAPEBADGER_API_KEY

Base URL

https://scrapebadger.com

---

Twitter/X API

Users

Get user profile by username:

GET /v1/twitter/users/{username}/by_username

Get user profile by numeric ID:

GET /v1/twitter/users/{user_id}/by_id

Batch get users by usernames (comma-separated):

GET /v1/twitter/users/batch_by_usernames?usernames=elonmusk,OpenAI

Batch get users by IDs (comma-separated):

GET /v1/twitter/users/batch_by_ids?user_ids=44196397,1230113324

Search users:

GET /v1/twitter/users/search_users?query=AI+agents

Get followers:

GET /v1/twitter/users/{username}/followers

Get following:

GET /v1/twitter/users/{username}/followings

Get mentions:

GET /v1/twitter/users/{username}/mentions

Get subscriptions:

GET /v1/twitter/users/{user_id}/subscriptions

Get user articles:

GET /v1/twitter/users/{user_id}/articles

Tweets

Get tweet by ID:

GET /v1/twitter/tweets/tweet/{tweet_id}

Get multiple tweets by IDs:

GET /v1/twitter/tweets/?tweets=123,456,789

Advanced search:

GET /v1/twitter/tweets/advanced_search?query=web+scraping&query_type=Latest&count=20

Get replies:

GET /v1/twitter/tweets/tweet/{tweet_id}/replies

Get quotes:

GET /v1/twitter/tweets/tweet/{tweet_id}/quotes

Get retweeters:

GET /v1/twitter/tweets/tweet/{tweet_id}/retweeters

Get favoriters (likes):

GET /v1/twitter/tweets/tweet/{tweet_id}/favoriters

Get similar tweets:

GET /v1/twitter/tweets/tweet/{tweet_id}/similar

Get edit history:

GET /v1/twitter/tweets/tweet/{tweet_id}/edit_history

Get community notes:

GET /v1/twitter/tweets/tweet/{tweet_id}/community_notes

Get article:

GET /v1/twitter/tweets/article/{article_id}

Communities

Get community:

GET /v1/twitter/communities/{community_id}

Get community tweets:

GET /v1/twitter/communities/{community_id}/tweets

Search communities:

GET /v1/twitter/communities/search?query=AI

Lists

Get list details:

GET /v1/twitter/lists/{list_id}/detail

Get list tweets:

GET /v1/twitter/lists/{list_id}/tweets

Search tweets in list:

GET /v1/twitter/lists/{list_id}/search_tweets?query=keyword

Trends

Get trending topics:

GET /v1/twitter/trends/

Get trends by location (WOEID):

GET /v1/twitter/trends/place/{woeid}

Geo

Search places:

GET /v1/twitter/geo/search?query=New+York

Get place details:

GET /v1/twitter/geo/places/{place_id}

Spaces