# SocialData API Documentation

> SocialData API is a scalable and reliable API that simplifies the process of fetching data from social media websites. At the moment, we only support X (formerly Twitter). With SocialData API, you can easily retrieve tweets, user profiles, user followers/following and other information without the need for proxies or parsing Twitter responses. This ensures a seamless and hassle-free integration with your application, saving you valuable time and effort.

## Getting Started
- [Twitter/X Data API - Overview](https://docs.socialdata.tools/getting-started/overview.md): SocialData is a Twitter API (X API) for fetching tweets, user profiles, followers and more - flat-rate pricing and rate limits that scale with your app.
- [Twitter/X API Pricing](https://docs.socialdata.tools/getting-started/pricing.md): Twitter API pricing without overpriced subscriptions: pay per request for the Twitter/X data you fetch, with flat per-item rates and no monthly commitments.
- [Authentication](https://docs.socialdata.tools/getting-started/authentication.md): How to authenticate SocialData API requests with your API key, where to find your key and how to send the Authorization header.
- [Rate Limits](https://docs.socialdata.tools/getting-started/rate-limits.md): SocialData API rate limits and monthly caps explained: default per-endpoint limits, how throttling behaves and how to request a higher limit.
- [Errors](https://docs.socialdata.tools/getting-started/errors.md): Reference for SocialData API error codes and messages - what each HTTP status means and how to resolve the most common failures.
- [Getting help](https://docs.socialdata.tools/getting-started/getting-help.md): How to reach the SocialData support team, what to include in your message and where to check API status before reporting an issue.

## Data API
- [Twitter Search API - Get Search Results](https://docs.socialdata.tools/reference/get-search-results.md): Twitter search API endpoint for real-time Twitter/X search results. Flat-rate pricing of $0.0002 per tweet, flexible rate limits, no subscriptions.
- [Get Twitter User Profile - API Reference](https://docs.socialdata.tools/reference/get-user-profile.md): User lookup API: retrieve full profile details for any Twitter/X username. Flat-rate $0.0002 per request, flexible rate limits and no subscriptions.
- [Get User Profiles by IDs - API Reference](https://docs.socialdata.tools/reference/get-multiple-user-profiles.md): Retrieve up to 100 Twitter/X user profiles by ID in a single request. Flat-rate $0.0002 per profile, no subscription plans.
- [Get Twitter User Followers - API Reference](https://docs.socialdata.tools/reference/get-user-followers.md): Twitter followers API: retrieve all followers of any Twitter/X user. Flat-rate $0.0002 per follower, flexible rate limits and no subscriptions.
- [Get User Verified Followers - API Reference](https://docs.socialdata.tools/reference/get-user-verified-followers.md): Twitter followers API: retrieve every verified follower of any Twitter/X user. Flat-rate $0.0002 per follower, flexible rate limits and no subscriptions.
- [Get Twitter User Following List - API Reference](https://docs.socialdata.tools/reference/get-user-followings.md): Retrieve the full list of accounts a Twitter/X user follows. Flat-rate $0.0002 per followed user, flexible rate limits and no subscriptions.
- [Get User's Tweets and Replies - API Reference](https://docs.socialdata.tools/reference/get-user-tweets-replies.md): Twitter timeline API: retrieve all tweets and replies posted by a Twitter/X user. Flat-rate $0.0002 per tweet, flexible rate limits, no subscriptions.
- [Get Twitter User Mentions - API Reference](https://docs.socialdata.tools/reference/get-user-mentions.md): Retrieve mentions of any Twitter/X username. Flat-rate $0.0002 per mention, flexible rate limits and no overpriced subscription plans.
- [Get Twitter User Highlights - API Reference](https://docs.socialdata.tools/reference/get-user-highlights.md): Retrieve a Twitter/X user's highlighted tweets. Flat-rate $0.0002 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get User Affiliates - API Reference](https://docs.socialdata.tools/reference/get-user-affiliates.md): Retrieve all affiliated profiles of a Twitter/X user. Flat-rate $0.0002 per affiliated profile, flexible rate limits and no subscriptions.
- [Get User's Lists - API Reference](https://docs.socialdata.tools/reference/get-user-lists.md): API endpoint to retrieve all user's lists on Twitter/X. Flat-rate pricing of $0.0002 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get User's Twitter Likes - API Reference](https://docs.socialdata.tools/reference/get-user-likes.md): Retrieve every tweet a Twitter/X user has liked. Flat-rate $0.0002 per tweet, flexible rate limits and no subscription plans.
- [Get User's Extended Twitter Bio - API Reference](https://docs.socialdata.tools/reference/get-user-extended-bio.md): API endpoint to retrieve a user's extended bio on Twitter/X. Flat-rate pricing of $0.001 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get User Similar Profiles - API Reference](https://docs.socialdata.tools/reference/get-user-similar-profiles.md): Retrieve Twitter/X profiles similar to a given user. Flat-rate $0.0002 per user, flexible rate limits and no overpriced subscription plans.
- [Get Tweet by ID (Tweet Lookup) - API Reference](https://docs.socialdata.tools/reference/get-tweet.md): Retrieve tweet contents and stats - comments, likes, retweets and quotes. Flat-rate $0.0002 per tweet, flexible rate limits, no subscriptions.
- [Get Multiple Tweets by IDs - API Reference](https://docs.socialdata.tools/reference/get-multiple-tweets.md): Retrieve contents and stats for multiple tweets in one request. Flat-rate $0.0002 per tweet, flexible rate limits and no subscription plans.
- [Get Tweet Comments - API Reference](https://docs.socialdata.tools/reference/get-tweet-comments.md): API endpoint to retrieve tweet comments. Flat-rate pricing of $0.0002 per comment, flexible rate limits and no overpriced subscription plans.
- [Get Tweet Quotes - API Reference](https://docs.socialdata.tools/reference/get-tweet-quotes.md): Retrieve all quote-tweets of any tweet. Flat-rate $0.0002 per quote-tweet, flexible rate limits and no subscription plans.
- [Get Tweet Retweeters List - API Reference](https://docs.socialdata.tools/reference/get-tweet-retweeters.md): Twitter retweeters API: retrieve every user who retweeted a given tweet. Flat-rate $0.0002 per user profile, flexible rate limits, no subscriptions.
- [Get Tweets in a Twitter Thread  - API Reference](https://docs.socialdata.tools/reference/get-tweet-thread.md): Retrieve every tweet in a Twitter/X thread. Flat-rate $0.0002 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get Twitter Article - API Reference](https://docs.socialdata.tools/reference/get-tweet-article.md): API endpoint to retrieve Twitter article contents. Flat-rate pricing of $0.0002 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get Article (v2) - API Reference](https://docs.socialdata.tools/reference/get-article-v2.md): API endpoint returning a Twitter/X article as ready-to-use Markdown instead of a raw Draft.js tree. Flat-rate pricing of $0.0002 per request.
- [Get Twitter Space Details - API Reference](https://docs.socialdata.tools/reference/get-space-details.md): API endpoint to retrieve Twitter Space details. Flat-rate pricing of $0.0002 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get Twitter List Details - API Reference](https://docs.socialdata.tools/reference/get-list-details.md): API endpoint to retrieve details of any list. Flat-rate pricing of $0.0002 per request, flexible rate limits and no overpriced subscription plans.
- [Get List Members - API Reference](https://docs.socialdata.tools/reference/get-list-members.md): Retrieve every member of any Twitter/X list. Flat-rate $0.0002 per user profile, flexible rate limits and no subscription plans.
- [Get List Tweets - API Reference](https://docs.socialdata.tools/reference/get-list-tweets.md): Retrieve tweets published by members of any Twitter/X list. Flat-rate $0.0002 per tweet, flexible rate limits and no subscription plans.
- [Get Twitter Community Details - API Reference](https://docs.socialdata.tools/reference/get-community-details.md): Retrieve details about any Twitter/X community. Flat-rate $0.0002 per request, flexible rate limits and no subscription plans.
- [Get Community Tweets - API Reference](https://docs.socialdata.tools/reference/get-community-tweets.md): Retrieve every tweet posted in a Twitter/X community. Flat-rate $0.0002 per tweet, flexible rate limits and no overpriced subscription plans.
- [Get Community Members - API Reference](https://docs.socialdata.tools/reference/get-community-members.md): Retrieve the members of a Twitter/X community and their roles. Flat-rate $0.0002 per profile, flexible rate limits and no subscription plans.
- [Get Community Search Results - API Reference](https://docs.socialdata.tools/reference/get-community-search-results.md): Retrieve real-time search results from within a Twitter/X community. Flat-rate $0.0002 per tweet, flexible rate limits and no subscriptions.

## Social Actions API
- [Verify User Is Following - Social Actions API](https://docs.socialdata.tools/social-actions/verify-user-following.md): Confirm whether one Twitter/X user follows another. Low-cost, low-latency check that avoids scraping the full followers list.
- [Verify User Retweeted - Social Actions API](https://docs.socialdata.tools/social-actions/verify-user-retweeted.md): API endpoint to confirm that a user has retweeted a particular tweet on Twitter/X, without pulling the full retweeter list.
- [Verify User Commented - Social Actions API](https://docs.socialdata.tools/social-actions/verify-user-commented.md): API endpoint to confirm that a user has commented on a particular tweet on Twitter/X.

## Monitoring API
- [Twitter Account Monitoring API - Introduction](https://docs.socialdata.tools/monitoring/introduction.md): A monitoring API to receive notifications when a user tweets, follows a new account, or makes a change to their user profile information
- [Processing Webhooks - API Reference](https://docs.socialdata.tools/monitoring/processing-webhooks.md): How SocialData delivers monitor events to your webhook URL, the payload shape for each event type, and how to recover events your endpoint missed
- [Verifying Webhooks - API Reference](https://docs.socialdata.tools/monitoring/verifying-webhooks.md): How to verify the authenticity of SocialData webhook requests using the X-Signature header, HMAC-SHA256 and your webhook secret
- [Pricing - Twitter Monitoring API](https://docs.socialdata.tools/monitoring/pricing.md): How SocialData Monitoring API monitors are billed - flat hourly rates for user monitors, per-execution billing for search monitors
- [Set Global Webhook URL - API Reference](https://docs.socialdata.tools/monitoring/set-global-webhook-url.md): Used to set the webhook URL that will be used for all monitors that don't have a monitor-specific webhook_url set
- [Set Webhook Secret - API Reference](https://docs.socialdata.tools/monitoring/set-webhook-secret.md): Set or rotate the shared secret used to sign SocialData webhook requests, so your server can verify their authenticity
- [Create New User Tweets Monitor - API Reference](https://docs.socialdata.tools/monitoring/create-user-tweets-monitor.md): Create a monitor that sends a webhook whenever a target Twitter/X user posts a new tweet or retweet, with the full tweet payload included.
- [Create User Following Monitor - API Reference](https://docs.socialdata.tools/monitoring/create-user-following-monitor.md): Create a monitor that sends a webhook whenever a target Twitter/X user follows someone new, with the full profile of each account followed.
- [Create User Profile Monitor - API Reference](https://docs.socialdata.tools/monitoring/create-user-profile-monitor.md): Create a monitor that sends a webhook whenever a target Twitter/X user updates their profile - bio, location, avatar or display name.
- [Create New Search Query Monitor - API Reference](https://docs.socialdata.tools/monitoring/create-search-query-monitor.md): Create a monitor for any custom Twitter/X search query and get a webhook when a new tweet matches. Flat rate of $0.0002 per tweet found.
- [Get Monitor Details - API Reference](https://docs.socialdata.tools/monitoring/get-monitor-details.md): API endpoint to retrieve the configuration and current status of a single Twitter/X monitor by its ID.
- [List Active Monitors - API Reference](https://docs.socialdata.tools/monitoring/list-active-monitors.md): API endpoint to list all active Twitter/X monitors on your account, with their type, target and webhook configuration.
- [Monitor Event History - API Reference](https://docs.socialdata.tools/monitoring/monitor-event-history.md): List the webhook events a monitor has delivered and inspect the exact payload and response for any single event
- [Edit Monitor Webhook URL - API Reference](https://docs.socialdata.tools/monitoring/edit-monitor-webhook.md): API endpoint to update the monitor-specific webhook URL, overriding the global webhook URL for a single Twitter/X monitor.
- [Delete Monitor - API Reference](https://docs.socialdata.tools/monitoring/delete-monitor.md): API endpoint to permanently delete a Twitter/X monitor and stop all webhook deliveries associated with it.

## MCP Server
- [MCP Server - Introduction](https://docs.socialdata.tools/mcp/introduction.md): Connect Claude, Cursor and other AI assistants directly to Twitter/X data using the SocialData MCP server and your existing API key
- [Connect Your Client to the MCP Server](https://docs.socialdata.tools/mcp/connecting.md): Configuration for Claude Code, Claude Desktop, Cursor and Windsurf to connect to the SocialData MCP server
- [Available MCP tools](https://docs.socialdata.tools/mcp/tools.md): The 14 read-only tools exposed by the SocialData MCP server, their parameters and the data they return

## Resources
- [Twitter Advanced Search Operators](https://docs.socialdata.tools/resources/twitter-search-operators.md): A complete reference of the Twitter/X advanced search operators supported by the SocialData Twitter search API, with examples for each.

## Other
- [Get User Profiles by Usernames - API Reference](https://docs.socialdata.tools/reference/get-multiple-user-profiles-by-usernames.md): Retrieve up to 100 Twitter/X user profiles by username in a single request. Flat-rate $0.0002 per profile, no subscription plans.