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

{
  "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"
}
​
url
string
Single social media URL to extract from. Either url or urls is required. See supported platforms for the full list (LinkedIn, Instagram, X, Reddit, Facebook, TikTok, YouTube, Pinterest, Bluesky, Snapchat, Google Maps).
​
urls
string[]
Array of URLs for batch extraction. Either url or urls is required. Batch size is provider-dependent — non-batch providers process one URL per request.
​
provider
string
required
Service slug of the form <provider>/<platform>/<type> (with an optional :<tag> suffix), e.g. apify/linkedin/profile.info or apify/linkedin/profile.posts:apimaestro. Copy-paste-friendly from the providers page; fully specifies the routing target.
  • <provider> — e.g. apify, brightdata
  • <platform> — one of: linkedin, instagram, x, reddit, facebook, tiktok, youtube, pinterest, bluesky, snapchat, googlemaps
  • <type> — one of: post.likes, post.comments, post.info, profile.info, profile.posts, profile.reels, profile.shorts, profile.followers, company.info, company.reviews, group.posts, job.listings, event.info, marketplace.listings, video.info, video.transcript, channel.info, playlist.posts, hashtag.posts, place.info, place.reviews
  • <tag> (optional) — selects a specific actor/dataset variant when the provider exposes more than one for that platform+type. Omit to use the provider’s default.
Not every combination is supported — query GET /v1/providers for live coverage.
​
limit
number
default:"100"
Maximum number of records to return. Hard-capped at 250 on /v1/extract to fit the per-provider deadline; larger pulls require the async API (soon).
​
fallback
boolean
default:"true"
Whether to walk the provider chain if the requested provider fails. Set to false to attempt only the requested provider and surface its error directly. The chain is built per (platform, type) and ordered by per-record cost ascending; the requested provider is always tried first.
​
options
object
Per-actor input overrides as a plain JSON object. Each actor decides which keys it honors via its buildInput allowlist — unknown keys are dropped server-side. Use this for actor-specific knobs that don’t have a first-class slot in the request body (e.g. proxyCountry, language). Layered on top of the actor’s defaults.
curl -X POST https://api.socialrouter.io/v1/extract \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/in/satyanadella",
    "provider": "apify/linkedin/profile.info"
  }'

{
  "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"
}