Quickstart - SocialRouter

1. Get your API key

Sign up at socialrouter.io and create an API key from the dashboard. Your key starts with sr_live_.

2. Call a service

Each service has its own endpoint: POST /v1/extract/{platform}/{service}. Here, linkedin/profile.info.

curl -X POST https://api.socialrouter.io/v1/extract/linkedin/profile.info \
  -H "Authorization: Bearer sr_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/in/satyanadella"
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/extract/linkedin/profile.info",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.linkedin.com/in/satyanadella",
    }),
  },
);

const run = await response.json();
console.log(run.data);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/extract/linkedin/profile.info",
    headers={"Authorization": "Bearer sr_live_your_key_here"},
    json={"url": "https://www.linkedin.com/in/satyanadella"},
)

run = response.json()
print(run["data"])

import { SocialRouter } from "@socialrouter/sdk";

const sr = new SocialRouter({ apiKey: "sr_live_your_key_here" });

const run = await sr.run("linkedin/profile.info", {
  url: "https://www.linkedin.com/in/satyanadella",
});

console.log(run.data);

No provider field: the router picks the offer and falls over to the next one if it fails.

3. Read the response

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "linkedin",
  "service": "profile.info",
  "url": "https://www.linkedin.com/in/satyanadella",
  "served_by": "brightdata/linkedin",
  "credits_used": 0.001725,
  "data": [
    {
      "name": "Satya Nadella",
      "title": "Chairman and CEO at Microsoft",
      "company": "Microsoft",
      "location": "Redmond, Washington",
      "profile_url": "https://www.linkedin.com/in/satyanadella",
      "source": "linkedin",
      "extracted_at": "2026-07-30T12:00:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  }
}

The call is synchronous: the response is already completed or failed. served_by names the offer that answered. The same request tomorrow may be served by another one, with the same output shape.

4. Find other services

curl https://api.socialrouter.io/v1/services/reddit

Every entry tells you the endpoint, whether it takes urls or queries, the exact input shapes it accepts (with examples), the typed options it supports, and the offers behind it. No authentication needed.

curl -X POST https://api.socialrouter.io/v1/extract/reddit/subreddit.posts \
  -H "Authorization: Bearer sr_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.reddit.com/r/programming",
    "limit": 50,
    "options": { "sort": "top", "time": "week" }
  }'

What’s next

Services & offers

The grammar: what a service is, what an offer is, how routing works.

Authentication

API keys, rate limits, per-key credit limits.