Services
Get a run
Retrieve the status and results of a past run by ID.
GET
/
v1
/
extractions
/
{id}
curl https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4 \
-H "Authorization: Bearer sr_live_your_key"
const response = await fetch(
"https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4",
{ headers: { "Authorization": "Bearer sr_live_your_key" } }
);
import requests
response = requests.get(
"https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4",
headers={"Authorization": "Bearer sr_live_your_key"},
)
const run = await sr.getExtraction("ext_a1b2c3d4");
{
"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
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:01Z"
}
{
"id": "ext_e5f6g7h8",
"status": "completed",
"platform": "googlemaps",
"service": "place.search",
"url": "coffee shops in Brooklyn",
"queries": ["coffee shops in Brooklyn"],
"served_by": "apify/compass",
"credits_used": 0.1656,
"data": [/* place records */],
"pagination": { "total": 30, "returned": 30 },
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:18Z"
}
{
"error": {
"code": "not_found",
"message": "Extraction ext_a1b2c3d4 not found.",
"type": "not_found"
}
}
Works for any service. For query-kind services, the original list of queries is echoed back under
queries and url holds the first query.
Runs are scoped to the authenticated key’s account: an ID belonging to another account is indistinguishable from a nonexistent one (404, never 403).
string
required
The run ID (e.g.,
ext_a1b2c3d4).curl https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4 \
-H "Authorization: Bearer sr_live_your_key"
const response = await fetch(
"https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4",
{ headers: { "Authorization": "Bearer sr_live_your_key" } }
);
import requests
response = requests.get(
"https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4",
headers={"Authorization": "Bearer sr_live_your_key"},
)
const run = await sr.getExtraction("ext_a1b2c3d4");
{
"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
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:01Z"
}
{
"id": "ext_e5f6g7h8",
"status": "completed",
"platform": "googlemaps",
"service": "place.search",
"url": "coffee shops in Brooklyn",
"queries": ["coffee shops in Brooklyn"],
"served_by": "apify/compass",
"credits_used": 0.1656,
"data": [/* place records */],
"pagination": { "total": 30, "returned": 30 },
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:18Z"
}
{
"error": {
"code": "not_found",
"message": "Extraction ext_a1b2c3d4 not found.",
"type": "not_found"
}
}
⌘I
curl https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4 \
-H "Authorization: Bearer sr_live_your_key"
const response = await fetch(
"https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4",
{ headers: { "Authorization": "Bearer sr_live_your_key" } }
);
import requests
response = requests.get(
"https://api.socialrouter.io/v1/extractions/ext_a1b2c3d4",
headers={"Authorization": "Bearer sr_live_your_key"},
)
const run = await sr.getExtraction("ext_a1b2c3d4");
{
"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
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:01Z"
}
{
"id": "ext_e5f6g7h8",
"status": "completed",
"platform": "googlemaps",
"service": "place.search",
"url": "coffee shops in Brooklyn",
"queries": ["coffee shops in Brooklyn"],
"served_by": "apify/compass",
"credits_used": 0.1656,
"data": [/* place records */],
"pagination": { "total": 30, "returned": 30 },
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:18Z"
}
{
"error": {
"code": "not_found",
"message": "Extraction ext_a1b2c3d4 not found.",
"type": "not_found"
}
}