Skip to main content
In this quickstart, you will create an account, get an API key, and send your first request. It takes about 3–5 minutes.

​
1️⃣ Get your API key

  1. Open api.sorsa.io/overview
  2. Click Sign in / Log in. Register using any option you prefer (we do not ask for extra personal information).
  3. Choose a Plan (10k, 100k, or 500k requests) and Billing (monthly or yearly).
  4. Select a payment method (Crypto or Card) and complete the payment.
  5. After confirmation, your dashboard will display:
    • Your API Key 🔑
    • Your Remaining Requests 📊
⚠️ Security Note: Keep your API key private. Never expose it in frontend code or public repositories.

​
2️⃣ Authentication & Usage

Sorsa.io uses a custom header for authentication.
  • Header Name: ApiKey
  • Base URL: https://api.sorsa.io/v3
Monitor Your Quota: Before running heavy queries, check your status: GET https://api.sorsa.io/v3/key-usage-info

​
3️⃣ Your First Request: Retrieve User Info

To fetch profile data using a username (handle), use the /info endpoint. cURL Example: Bash 
curl -X GET "https://api.sorsa.io/v3/info?link=elonmusk" \
     -H "ApiKey: YOUR_API_KEY_HERE"
Example Response: JSON 
{
  "id": "44196397",
  "name": "Elon Musk",
  "screen_name": "elonmusk",
  "description": "...",
  "followers_count": 235391643,
  "friends_count": 1289,
  "register_date": "2009-06-02",
  "tweets_count": 98059,
  "verified": true,
  "can_dm": false
}

​
4️⃣ Python Implementation

Using the requests library is the most straightforward way to integrate Sorsa.io. Python 
import requests

API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.sorsa.io/v3"

def get_user_info(username):
    url = f"{BASE_URL}/info"
    headers = {"ApiKey": API_KEY}
    params = {"link": username}
    
    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status() 
        return response.json()
    except requests.exceptions.RequestException as e:
        return {"error": str(e)}

print(get_user_info("elonmusk"))

​
❌ Error Codes

CodeMeaning
200Success
400Bad Request
403Unauthorized
404Not Found
429Too Many Requests
500Server Error
📘 Full Error Reference: For a detailed breakdown of all error types and how to handle them, see the Error Codes Dictionary.

​
⏭ Next steps