SocialData

SocialData API Reference

SocialData API is a scalable and reliable API that simplifies the process of fetching data from Twitter/X. With SocialData API, you can easily retrieve…

Social#social

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

SocialData API is a scalable and reliable API that simplifies the process of fetching data from Twitter/X. 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.

Endpoints 48

Data API

  • GETGet Search Results/twitter/search?query=from:elonmusk doge -filter:repliesReturns array of tweets provided by Twitter search. Typically Twitter returns ~20 results per page. You can request additional search results by sending…
  • GETGet User Profile by Username/twitter/user/:usernameRetrieve detailed user information by their Twitter username.
  • GETGet User Profile by ID/twitter/user/:user_idRetrieve detailed user profile information by their Twitter numerical ID.
  • POSTGet Multiple User Profiles by IDs/twitter/users-by-idsRetrieve user information for up to 100 Twitter users in a single request.
  • POSTGet Multiple User Profiles By Usernames/twitter/users-by-usernamesRetrieve user information for up to 100 Twitter users in a single request based on array of usernames.
  • POSTGet Multiple Tweets/twitter/tweets-by-idsRetrieve contents and stats for up to 100 tweets in a single request. Returns an array of tweet objects. Tweets that could not be retrieved are omitted from…
  • GETGet User Followers/twitter/user/:user_id/followersReturns an array of user profiles that are following the target profile identified by user_id. The profiles are returned in reverse chronological order, with…
  • GETGet User Verified Followers/twitter/user/:user_id/verified-followersReturns an array of verified user profiles that are following the target profile identified by user_id. The profiles are returned in reverse chronological…
  • GETGet User Following List/twitter/user/:user_id/followingReturns an array of user profiles that the target profile identified by user_id is following. The profiles are returned in reverse chronological order, with…
  • GETGet User's Tweets/twitter/user/:user_id/tweetsReturns array of tweets from the user's tweets timeline. Typically Twitter returns ~20 results per page. You can request additional search results by sending…
  • GETGet User's Tweets and Replies/twitter/user/:user_id/tweets-and-repliesReturns array of tweets from the user's tweets and replies timeline, including both original tweets and replies. Typically Twitter returns ~20 results per…
  • GETGet User Mentions/twitter/user/:username/mentionsRetrieves tweets that mention the specified Twitter user. Typically returns ~20 results per page. You can request additional results by sending another…
  • GETGet User Highlighted Tweets/twitter/user/:user_id/highlightsReturns array of tweets from the user's Highlights tab. Typically Twitter returns ~20 results per page. You can request additional results by sending another…
  • GETGet User Affiliates/twitter/user/:user_id/affiliatesVerified organization profiles (i.e. users with the gold checkmark) occasionally have affiliated accounts listed under "Affiliates" tab on their profile page.…
  • GETGet User's Lists/twitter/user/:user_id/listsReturns array of lists a user created or is subscribed to. Typically Twitter returns up to 100 lists per page. You can request additional results by sending…
  • GETGet User's Extended Twitter Bio/twitter/user/:username/extended-bioReturns an object with user's extended bio with all text and formatting details, or an empty object if the extended bio is missing.
  • GETGet Similar User Profiles/twitter/user/:user_id/similarReturns an array of user profiles that Twitter/X considers similar to a given user.
  • GETGet Tweet/twitter/tweets/:tweet_idRetrieves complete tweet details by its ID.
  • GETGet Tweet Comments/twitter/tweets/:tweet_id/commentsReturns an array of comments for a given tweet_id. This endpoint only works for top-level tweets (i.e. this can't be used to retrieve comments posted in…
  • GETGet Tweet Retweeters List/twitter/tweets/:tweet_id/retweeted_byThis endpoint returns an array of user profiles that retweeted the target tweet identified by tweet_id. The profiles are returned in reverse chronological…
  • GETGet Tweet Quotes/twitter/tweets/:tweet_id/quotesReturns an array of quotes for a given tweet_id. This endpoint retrieves tweets that quote the target tweet.
  • GETGet Article/twitter/article/:article_idReturns a tweet with an article attached to it. The output contains the same properties as the tweet details endpoint; the article content is returned within…
  • GETGet Article (v2)/v2/twitter/article/:article_idReturns a Twitter/X article rendered as Markdown. Unlike the v1 Get Article endpoint, which returns X's raw Draft.js document tree as content_state, this…
  • GETGet Tweets in a Twitter Thread/twitter/thread/:thread_idReturns an array of tweets associated with a thread and a next_cursor value used to retrieve more pages (if the thread contains more than 30 posts).
  • GETGet Twitter Space Details/twitter/space/:space_idRetrieves detailed information about a Twitter Space by its ID.
  • GETGet List Details/twitter/list/:list_idRetrieves detailed information about a Twitter List by its ID.
  • GETGet List Members/twitter/list/:list_id/membersRetrieves members of a Twitter List by its ID.
  • GETGet List Tweets/twitter/list/:list_id/tweetsRetrieves tweets from a specific Twitter List by its ID.
  • GETGet Community Details/twitter/community/:community_idReturns information about a Twitter community.
  • GETGet Community Search Results/twitter/community/:community_id/search?query=from:elonmusk dogeReturns an array of tweets provided by the Twitter community search page. Typically Twitter returns ~20 results per page. You can request additional search…
  • GETGet Community Tweets/twitter/community/:community_id/tweetsReturns array of tweets from the community timeline. Typically Twitter returns ~20 results per page. You can request additional results by sending another…
  • GETGet Community Members/twitter/community/:community_id/membersReturns array of users who are admins, moderators or regular members of a community. Typically Twitter returns ~20 results per page. You can request…

Monitoring API

  • POSTSet Global Webhook URL/user/webhookUsed to set webhook URL that will be used for all monitors that don't have a monitor-specific webhook_url set.
  • POSTSet Webhook Secret/user/webhook/secretSets the shared secret used to sign every webhook we send you. Your server uses the same value to confirm a request is authentic. You choose the value; there…
  • POSTCreate New User Tweets Monitor/monitors/user-tweetsCreates a new monitor to receive alerts when the target Twitter user posts a new tweet or makes a retweet. When adding a new monitor SocialData will attempt…
  • POSTCreate Twitter User Following Monitor/monitors/user-followingCreates a new monitor to receive alerts when the target Twitter user follows someone.
  • POSTCreate Twitter User Profile Monitor/monitors/user-profileCreates a new monitor to receive alerts when the target Twitter user changes their profile. Changes in any of the following user profile properties will…
  • POSTCreate New Search Query Monitor/monitors/search-queryCreates a new search query monitor. SocialData will run your monitor every refresh_frequency seconds, retrieve recent search results for query, and dispatch…
  • GETList Active Monitors/monitorsReturns a list of monitors owned by the user.
  • GETGet Monitor Details/monitors/:monitor_idReturns details about a specific monitor.
  • DELETEDelete Monitor/monitors/:monitor_idDeletes an active monitor. This action stops the API from monitoring new events for the target user profile and halts all future charges associated with this…
  • PATCHEdit Monitor Settings/monitors/:monitor_idUpdates a single monitor's settings. You can change its webhook_url and, for search monitors, its refresh_frequency. Updating webhook_url only affects this…
  • GETList Monitor Events/monitors/:monitor_id/eventsReturns the delivery history for a monitor - one entry per webhook request we made, newest first. Use it to find deliveries your server rejected or never…
  • GETGet Monitor Event Details/monitors/:monitor_id/events/:event_idReturns a single event, including the full webhook payload we sent and the body your server responded with. The request_body value contains the exact JSON we…

Social Actions API

  • GETVerify User Following Relationship/twitter/user/:source_user_id/following/:target_user_idThis endpoint provides a convenient way to check if a user (identified by source_user_id) is following another user (identified by target_user_id). The…
  • GETVerify User Retweeted a Tweet/twitter/tweets/:tweet_id/retweeted_by/:user_idThis endpoint provides a convenient way to check if a user retweeted a tweet identified by tweet_id. This will recursively retrieve all users who recently…
  • GETVerify User Commented on a Tweet/twitter/tweets/:tweet_id/commented_by/:user_idThis endpoint provides a convenient way to check if a user identified by user_id posted a comment in response to a tweet identified by tweet_id. This endpoint…

SocialData Account Management

  • GETGet Remaining Balance/user/balanceReturns remaining SocialData balance in USD

API details

Base URL
https://api.socialdata.tools
Authentication
A bearer token in the Authorization header
Operations
48 operations on 46 pathsGET 37POST 9PATCH 1DELETE 1
Main resources
Data API 32Monitoring API 12Social Actions API 3SocialData Account Management 3
Response formats
application/json
Description format
OpenAPI 3.0.0, API version 1.0.0

How to test the SocialData API Reference in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the SocialData API Reference collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get Search Results” (GET /twitter/search?query=from:elonmusk doge -filter:replies), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the SocialData API Reference?

SocialData API is a scalable and reliable API that simplifies the process of fetching data from Twitter/X. With SocialData API, you can easily retrieve… It is listed under Social and has 48 endpoints.

Who publishes the SocialData API Reference?

It is listed from SocialData's public API description (an OpenAPI document), not published by SocialData on Swastik Codes. Anyone who controls socialdata.tools can claim the profile by adding a DNS TXT record.

What is the base URL of the SocialData API Reference?

Requests go to https://api.socialdata.tools. Endpoint paths are added to this base URL.

How do I authenticate with the SocialData API Reference?

With A bearer token in the Authorization header.

How many endpoints does the SocialData API Reference have?

48 operations on 46 paths (37 GET, 9 POST, 1 PATCH, 1 DELETE). The largest groups are Data API, Monitoring API, Social Actions API, SocialData Account Management.

Is forking the SocialData API Reference free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.