Skip to main content
All API requests are made over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

​
📍 Base URL

All current endpoints are relative to the following base URL: https://api.sorsa.io/v3 Full Endpoint Example: https://api.sorsa.io/v3/info?link=elonmusk

​
🏗 API Versioning Policy

We use URL versioning to ensure stability for your applications.
  • Current Version: v3 (Stable)
  • Status: Active & Recommended.

​
How we handle changes:

  • Non-breaking changes: Adding new optional parameters or new fields to the JSON response. These are done within the current version.
  • Breaking changes: If we remove fields or change core logic, we will release a new version (e.g., /v4/) and provide a clear sunset period for the previous one.

​
⚠️ Legacy Version (v2) Deprecation

Important: If you are still using the v2 endpoints of our API, please be advised that they are now considered Legacy.
  • Shutdown Date: May 1, 2026.
  • Action Required: All integrations must migrate to the v3 Base URL before this date to avoid service interruption.
  • Migration Support: See our Migration Guide for field mapping and structural changes.

​
📂 URL Structure

The Sorsa API is organized into logical categories to make navigation intuitive.
  • Base URL: https://api.sorsa.io/v3
  • Category: e.g., users-data, tweets, search
  • Endpoint: e.g., followers, user-tweets
Example path in documentation: https://api.sorsa.io/api-reference/users-data/followers

​
🚦 Request Requirements

  1. HTTPS Only: Requests made via plain http will be rejected.
  2. Method: Most data retrieval endpoints use the GET orPOSTmethod.
  3. Authentication: Every request must include the ApiKey header as described in Authentication.

​
⏭ Next Steps