SocialData.Tools: API Documentation
  • Getting Started
  • Authentication
  • Pricing
  • SDKs and Code Examples
  • Twitter: Tweets
    • Retrieve tweet details
    • Retrieve thread
    • Retrieve article details
    • Retrieve all users who retweeted a tweet
    • Retrieve search results by keyword
    • Retrieve all users who liked a tweet
  • Twitter: Users
    • Retrieve user profile details
    • Retrieve profile's affiliated users
    • Retrieve tweets and replies made by a specific user
    • Retrieve likes made by a specific user
    • Retrieve user's articles
    • Retrieve user's highlighted tweets
    • Retrieve user's followers
    • Retrieve user's following
    • Retrieve user's lists
    • Check if a user is following another user
    • Check if a user retweeted a specific tweet
    • Check if a user commented on a specific tweet
    • Check if a user liked a specific tweet
    • Retrieve users search results by screenname
  • Twitter: Lists
    • Retrieve list details
    • Retrieve list members
  • Twitter: Spaces
    • Retrieve Twitter spaces stream details
  • Twitter / X: Communities
    • Retrieve community tweets timeline
    • Retrieve community members
  • Twitter / X: Async Endpoints
    • Introduction
    • Getting job status
    • Using Webhooks
    • Retrieve large number of search results
    • Retrieve all comments for any tweet
Powered by GitBook
On this page
  • Obtaining Your API Key
  • Using Your API Key
  • Important Notes

Authentication

Each request to SocialData API needs to contain your API key. All unauthenticated requests are rejected.

Obtaining Your API Key

To authenticate with the SocialData API, you will need to obtain an API key. This key must be included in the Authorization header of every HTTP request you make. Follow these steps to get your Bearer token:

  1. Sign Up: Create an account on the SocialData platform.

  2. API Key: After signing up, generate your API key in user dashboard. Keep this key confidential, as it is your private access to the API.

Using Your API Key

Once you have your Bearer token, you can use it in the Authorization header with the keyword 'Bearer' followed by a space and then your token. Here's an example of what the Authorization header should look like:

Authorization: Bearer YOUR_API_KEY

Here’s a sample cURL request to illustrate how to include the Authorization header in your API calls:

curl -X GET "https://api.socialdata.tools/twitter/statuses/show?id=1740192018918170738" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"

Important Notes

  • Security: Do not expose your API Key publicly. Treat it as you would your password, as it grants access to your SocialData API service and budget.

  • Expiration: API Keys do not have an expiration date. However you are free to generate a new API key at any moment in your user dashboard.

PreviousGetting StartedNextPricing

Last updated 10 months ago