Extraction
Get extraction
Retrieve the status and results of an extraction or search by ID.
GET
/
v1
/
extract
/
{id}
curl https://api.socialrouter.io/v1/extract/ext_a1b2c3d4 \
-H "Authorization: Bearer sr_live_your_key"
const response = await fetch(
"https://api.socialrouter.io/v1/extract/ext_a1b2c3d4",
{ headers: { "Authorization": "Bearer sr_live_your_key" } }
);
import requests
response = requests.get(
"https://api.socialrouter.io/v1/extract/ext_a1b2c3d4",
headers={"Authorization": "Bearer sr_live_your_key"},
)
{
"id": "ext_a1b2c3d4",
"kind": "extract",
"status": "completed",
"source": "linkedin",
"type": "profile.info",
"url": "https://www.linkedin.com/in/satyanadella",
"provider": "apify",
"credits_used": 0.0065,
"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-04-10T12:00:00Z"
}
],
"pagination": {
"total": 1,
"returned": 1,
"next_cursor": null
},
"created_at": "2026-04-10T12:00:00Z",
"completed_at": "2026-04-10T12:00:01Z"
}
{
"id": "ext_e5f6g7h8",
"kind": "search",
"status": "completed",
"source": "googlemaps",
"type": "place.search",
"url": "",
"queries": ["coffee shops in Brooklyn"],
"provider": "apify",
"credits_used": 0.0900,
"data": [/* place records */],
"pagination": { "total": 30, "returned": 30, "next_cursor": null },
"created_at": "2026-04-10T12:00:00Z",
"completed_at": "2026-04-10T12:00:18Z"
}
{
"error": {
"code": "not_found",
"message": "Extraction ext_a1b2c3d4 not found.",
"type": "not_found"
}
}
Works for both extraction and search results — the response’s
kind field distinguishes between them ("extract" vs "search"). For searches, the original list of queries is echoed back under queries.
string
required
The extraction or search ID (e.g.,
ext_a1b2c3d4).curl https://api.socialrouter.io/v1/extract/ext_a1b2c3d4 \
-H "Authorization: Bearer sr_live_your_key"
const response = await fetch(
"https://api.socialrouter.io/v1/extract/ext_a1b2c3d4",
{ headers: { "Authorization": "Bearer sr_live_your_key" } }
);
import requests
response = requests.get(
"https://api.socialrouter.io/v1/extract/ext_a1b2c3d4",
headers={"Authorization": "Bearer sr_live_your_key"},
)
{
"id": "ext_a1b2c3d4",
"kind": "extract",
"status": "completed",
"source": "linkedin",
"type": "profile.info",
"url": "https://www.linkedin.com/in/satyanadella",
"provider": "apify",
"credits_used": 0.0065,
"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-04-10T12:00:00Z"
}
],
"pagination": {
"total": 1,
"returned": 1,
"next_cursor": null
},
"created_at": "2026-04-10T12:00:00Z",
"completed_at": "2026-04-10T12:00:01Z"
}
{
"id": "ext_e5f6g7h8",
"kind": "search",
"status": "completed",
"source": "googlemaps",
"type": "place.search",
"url": "",
"queries": ["coffee shops in Brooklyn"],
"provider": "apify",
"credits_used": 0.0900,
"data": [/* place records */],
"pagination": { "total": 30, "returned": 30, "next_cursor": null },
"created_at": "2026-04-10T12:00:00Z",
"completed_at": "2026-04-10T12:00:18Z"
}
{
"error": {
"code": "not_found",
"message": "Extraction ext_a1b2c3d4 not found.",
"type": "not_found"
}
}
Previous
List providersList all available providers with their status and pricing. No authentication required.
Next
⌘I
curl https://api.socialrouter.io/v1/extract/ext_a1b2c3d4 \
-H "Authorization: Bearer sr_live_your_key"
const response = await fetch(
"https://api.socialrouter.io/v1/extract/ext_a1b2c3d4",
{ headers: { "Authorization": "Bearer sr_live_your_key" } }
);
import requests
response = requests.get(
"https://api.socialrouter.io/v1/extract/ext_a1b2c3d4",
headers={"Authorization": "Bearer sr_live_your_key"},
)
{
"id": "ext_a1b2c3d4",
"kind": "extract",
"status": "completed",
"source": "linkedin",
"type": "profile.info",
"url": "https://www.linkedin.com/in/satyanadella",
"provider": "apify",
"credits_used": 0.0065,
"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-04-10T12:00:00Z"
}
],
"pagination": {
"total": 1,
"returned": 1,
"next_cursor": null
},
"created_at": "2026-04-10T12:00:00Z",
"completed_at": "2026-04-10T12:00:01Z"
}
{
"id": "ext_e5f6g7h8",
"kind": "search",
"status": "completed",
"source": "googlemaps",
"type": "place.search",
"url": "",
"queries": ["coffee shops in Brooklyn"],
"provider": "apify",
"credits_used": 0.0900,
"data": [/* place records */],
"pagination": { "total": 30, "returned": 30, "next_cursor": null },
"created_at": "2026-04-10T12:00:00Z",
"completed_at": "2026-04-10T12:00:18Z"
}
{
"error": {
"code": "not_found",
"message": "Extraction ext_a1b2c3d4 not found.",
"type": "not_found"
}
}