# ScrapeBadger: Twitter ## Twitter ### Overview - [API Reference](https://docs.scrapebadger.com/api-reference/introduction.md): Complete API reference for web scraping and Twitter data. 50+ endpoints for scraping any website and accessing Twitter data. ### Tweets - [Get Tweets by IDs](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweets-by-ids.md): Retrieve multiple tweets by their IDs in a single request. Returns comprehensive tweet data for each requested ID including text, media attachments, engagement metrics, and all available metadata. Useful for bulk tweet lookups and monitoring specific tweets. - [Get Tweet Detail](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweet-detail.md): Fetch detailed information about a single tweet. Returns comprehensive tweet data including author info, engagement stats, media attachments, polls, referenced tweets, and edit history. Use this for deep inspection of individual tweets. - [Get Tweet Retweeters](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweet-retweeters.md): Get the list of users who retweeted a specific tweet. Returns comprehensive user profile data for each retweeter with pagination support. Useful for analyzing tweet reach and audience engagement. - [Get Tweet Replies](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweet-replies.md): Get replies to a specific tweet. Returns comprehensive tweet data for each reply including text, media, engagement metrics, and author information. Supports pagination for tweets with many replies. - [Get Tweet Favoriters](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweet-favoriters.md): Get the list of users who favorited (liked) a specific tweet. Returns comprehensive user profile data for each user who liked the tweet. Useful for audience analysis and engagement tracking. - [Get Similar Tweets](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-similar-tweets.md): Get tweets that are similar in content or topic to the specified tweet. Returns tweets that Twitter's algorithm considers related. Useful for content discovery and topic analysis. - [Advanced Tweet Search](https://docs.scrapebadger.com/api-reference/endpoint/tweets/advanced-search.md): Search for tweets using advanced query syntax. Supports filtering by Top, Latest, or Media results. Use Twitter's advanced search operators in the query (e.g., `from:username`, `since:2024-01-01`, `min_faves:100`). Essential for monitoring, research, and content discovery. - [Get Tweet Edit History](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweet-edit-history.md): Get the edit history of a tweet. Returns all versions of the tweet in chronological order, from the original to the most recent edit. Useful for tracking changes to tweet content over time. - [Get Community Notes](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-community-notes.md): Get community notes (formerly Birdwatch) attached to a specific tweet. Community notes provide crowd-sourced context and fact-checking for tweets. Returns note text, status, and creation date. - [Get Tweet Quotes](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-tweet-quotes.md): Get tweets that quote the specified tweet. Returns comprehensive tweet data for each quote tweet including text, media, engagement metrics, and author information. Useful for tracking how a tweet is being discussed and shared. - [Get Article Detail](https://docs.scrapebadger.com/api-reference/endpoint/tweets/get-article-detail.md): Get a Twitter Article (long-form post) by its unique ID. Returns the full article content including title, body text, cover image, and author information. Twitter Articles are long-form content published directly on the platform. ### Users - [Batch Get Users by IDs](https://docs.scrapebadger.com/api-reference/endpoint/users/batch-get-users-by-ids.md): Fetch multiple user profiles by their numeric IDs in a single request. Returns comprehensive user profile data for each requested ID. More efficient than making individual requests when you need data for multiple users. - [Batch Get Users by Usernames](https://docs.scrapebadger.com/api-reference/endpoint/users/batch-get-users-by-usernames.md): Fetch multiple user profiles by their usernames (screen names) in a single request. Returns comprehensive user profile data for each requested username. More efficient than making individual requests when you need data for multiple users. - [Get User by ID](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-by-id.md): Get a user profile by their numeric Twitter ID. Returns comprehensive profile data including bio, follower/following counts, verification status, and account metadata. Use this when you have the numeric ID and need full profile details. - [Get User by Username](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-by-username.md): Get a user profile by their username (screen name). Returns comprehensive profile data including bio, follower/following counts, verification status, and account metadata. The most common way to look up a user profile. - [Get User Tweets](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-tweets.md): Get the latest tweets from a specific user's timeline. Returns comprehensive tweet data including text, media, engagement metrics, and all metadata. Supports pagination to retrieve the full tweet history. - [Get User Followers](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-followers.md): Get the list of followers for a specific user. Returns comprehensive user profile data for each follower with pagination support. Useful for audience analysis and social graph exploration. - [Get User Following](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-following.md): Get the list of users that a specific user is following. Returns comprehensive user profile data for each followed account with pagination support. Useful for understanding a user's interests and network. - [Get User Subscriptions](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-subscriptions.md): Get the premium account subscriptions for a specific user. Returns the list of accounts that the user subscribes to for premium content. Requires the user's numeric ID. - [Search Users](https://docs.scrapebadger.com/api-reference/endpoint/users/search-users.md): Search for users by username, display name, or keywords in their bio. Returns matching user profiles with comprehensive data. Useful for finding accounts related to specific topics or interests. - [Get User Mentions](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-mentions.md): Get tweets that mention a specific user. Returns tweets containing @username from the latest search results. Useful for monitoring brand mentions, tracking conversations, and reputation management. - [Get User Articles](https://docs.scrapebadger.com/api-reference/endpoint/users/get-user-articles.md): Get long-form articles (Twitter Articles) written by a specific user. Returns article metadata including title, body text, cover image, and publication date. Requires the user's numeric ID. ### Lists - [Get List Details](https://docs.scrapebadger.com/api-reference/endpoint/lists/get-list-details.md): Get detailed information about a Twitter list. Returns comprehensive list details including name, description, member count, subscriber count, visibility mode, and owner information. Useful for understanding list composition before fetching its tweets. - [Get List Tweets](https://docs.scrapebadger.com/api-reference/endpoint/lists/get-list-tweets.md): Get tweets from a specific Twitter list. Returns comprehensive tweet data from the list's timeline including all metadata, media attachments, and engagement metrics. Supports pagination for lists with many tweets. - [Search List Tweets](https://docs.scrapebadger.com/api-reference/endpoint/lists/search-list-tweets.md): 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. ### Communities - [Get Community Details](https://docs.scrapebadger.com/api-reference/endpoint/communities/get-community-details.md): Get detailed information about a Twitter community. Returns comprehensive community data including name, description, member count, join policy, banner image, creator/admin info, and community rules. Useful for understanding a community before exploring its content. - [Get Community Tweets](https://docs.scrapebadger.com/api-reference/endpoint/communities/get-community-tweets.md): Get tweets from a specific community. Returns tweets posted within the community, filterable by type (Top, Latest, or Media). Supports pagination for communities with extensive content. - [Search Communities](https://docs.scrapebadger.com/api-reference/endpoint/communities/search-communities.md): Search for Twitter communities by name, description, or keywords. Returns matching communities with comprehensive information including member count, join policy, and description. Useful for discovering communities related to specific topics. ### Trends - [Get Trending Topics](https://docs.scrapebadger.com/api-reference/endpoint/trends/get-trending-topics.md): Get current trending topics on Twitter. Results can be filtered by category: trending (default), for-you, news, sports, or entertainment. Returns trend names, tweet counts, and context information. - [Get Trends by Location](https://docs.scrapebadger.com/api-reference/endpoint/trends/get-trends-by-location.md): Get trending topics for a specific geographic location identified by its WOEID (Where On Earth ID). Returns location-specific trends including trend names, tweet volumes, and search URLs. Use WOEID 1 for worldwide trends, or 23424977 for United States. ### Geo - [Search Places](https://docs.scrapebadger.com/api-reference/endpoint/geo/search-places.md): Search for geographic places that can be attached to tweets. At least one of `query`, `lat`/`long`, or `ip` must be provided. Results can be filtered by granularity (neighborhood, city, admin, country). Useful for geo-tagging and location-based analysis. - [Get Place Details](https://docs.scrapebadger.com/api-reference/endpoint/geo/get-place-details.md): Get detailed information about a specific geographic place. Returns comprehensive place data including full name, country, place type, bounding box coordinates, and additional attributes. Use place IDs obtained from the geo search endpoint. ### Spaces - [Get Broadcast Details](https://docs.scrapebadger.com/api-reference/endpoint/spaces/get-broadcast-details.md): Get details of a live video broadcast on Twitter. Returns broadcast metadata including title, current state, media key, dimensions, viewer counts, and timestamps. Useful for monitoring live content on the platform. - [Get Space Details](https://docs.scrapebadger.com/api-reference/endpoint/spaces/get-space-details.md): Get details of a Twitter Space (audio room). Returns Space metadata including title, current state, creator information, participant counts, and scheduling details. Useful for monitoring live audio content and upcoming events. ### Twitter Streams - [Twitter Streams Overview](https://docs.scrapebadger.com/twitter-streams/overview.md): Real-time Twitter monitoring with Stream Monitors and Filter Rules - [Stream Monitors](https://docs.scrapebadger.com/twitter-streams/monitors.md): Monitor specific Twitter accounts in real-time - [Filter Rules](https://docs.scrapebadger.com/twitter-streams/filter-rules.md): Monitor Twitter search queries in real-time - [WebSocket Delivery](https://docs.scrapebadger.com/twitter-streams/websocket.md): Connect via WebSocket for real-time tweet streaming - [Webhook Delivery](https://docs.scrapebadger.com/twitter-streams/webhooks.md): Receive HMAC-SHA256 signed HTTP callbacks for detected tweets ### Stream Monitors API - [Create Stream Monitor](https://docs.scrapebadger.com/api-reference/endpoint/streams/create-stream-monitor.md): Create a new stream monitor to track one or more Twitter accounts in real time. New tweets from monitored accounts are delivered via WebSocket and optionally via webhook. Each monitored account consumes credits per day based on volume pricing. - [List Stream Monitors](https://docs.scrapebadger.com/api-reference/endpoint/streams/list-stream-monitors.md): List all stream monitors for the authenticated API key. Supports pagination and optional filtering by status. - [Get Stream Monitor](https://docs.scrapebadger.com/api-reference/endpoint/streams/get-stream-monitor.md): Retrieve details of a specific stream monitor by its ID. Returns full monitor configuration, status, and pricing information. - [Update Stream Monitor](https://docs.scrapebadger.com/api-reference/endpoint/streams/update-stream-monitor.md): Update an existing stream monitor. All fields are optional; only provided fields will be updated. Use status field to pause or resume monitoring. - [Delete Stream Monitor](https://docs.scrapebadger.com/api-reference/endpoint/streams/delete-stream-monitor.md): Permanently delete a stream monitor and stop all associated monitoring. This action cannot be undone. - [Create Webhook](https://docs.scrapebadger.com/api-reference/endpoint/streams/create-webhook.md): Create a new webhook endpoint for a stream monitor. Webhooks receive HMAC-SHA256 signed POST requests when new tweets are detected. - [List Webhooks](https://docs.scrapebadger.com/api-reference/endpoint/streams/list-webhooks.md): List all webhooks for the authenticated API key. Optionally filter by monitor ID. - [Delete Webhook](https://docs.scrapebadger.com/api-reference/endpoint/streams/delete-webhook.md): Permanently delete a webhook endpoint. The stream monitor will continue operating but will no longer deliver to this webhook URL. - [Test Webhook](https://docs.scrapebadger.com/api-reference/endpoint/streams/test-webhook.md): Send a test payload to the webhook configured for a stream monitor. Returns the HTTP status code and response time from the webhook endpoint. Useful for verifying webhook connectivity before going live. - [List Delivery Logs](https://docs.scrapebadger.com/api-reference/endpoint/streams/list-delivery-logs.md): List tweet delivery logs for stream monitors. Shows each detected tweet with detection latency, delivery status, and webhook response details. Useful for monitoring stream health and debugging delivery issues. - [List Billing Logs](https://docs.scrapebadger.com/api-reference/endpoint/streams/list-billing-logs.md): List billing logs for stream monitors. Shows credit deductions with billing cadence details, tier rates, and account counts. Useful for tracking streaming costs and verifying billing accuracy. ### Filter Rules API - [Create Filter Rule](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/create-filter-rule.md): Create a new filter rule that monitors Twitter using an Advanced Search query at a configurable polling interval. Matching tweets are delivered via WebSocket and optionally via webhook. Pricing is based on the polling interval tier. - [List Filter Rules](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/list-filter-rules.md): List all filter rules for the authenticated API key. Supports pagination and optional filtering by status. - [Get Filter Rule](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/get-filter-rule.md): Retrieve details of a specific filter rule by its ID. Returns full rule configuration, status, and pricing information. - [Update Filter Rule](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/update-filter-rule.md): Update an existing filter rule. All fields are optional; only provided fields will be updated. Changing the interval may affect the pricing tier. - [Delete Filter Rule](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/delete-filter-rule.md): Permanently delete a filter rule and stop all associated polling. This action cannot be undone. - [Validate Filter Rule Query](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/validate-filter-rule.md): Validate a Twitter Advanced Search query without creating a filter rule. Returns whether the query syntax is valid and any errors found. Use this to test queries before creating filter rules. - [Get Filter Rule Logs](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/get-filter-rule-logs.md): List tweet delivery logs for a specific filter rule. Shows each detected tweet with detection latency, delivery status, and webhook response details. - [Get Filter Rule Pricing](https://docs.scrapebadger.com/api-reference/endpoint/filter-rules/get-filter-rule-pricing.md): Retrieve the pricing tiers for filter rules. Each tier defines a maximum polling interval and the corresponding credit cost per rule per day. Use this to estimate costs before creating filter rules.