Profile API - Superdata Docs

Get a profile

GET https://api.superdata.so/v1/profile

The Profile API returns structured public profile data such as identity, headline, location, employment, and education. Every request requires a Bearer API key.

Query parameters

Provide at least one identifier. If you send more than one, Superdata uses url, then person.id, then user_id, then profile_id.

Parameter	Type	Default	Description
`url`	URL	—	Public LinkedIn `/in/` or `/pub/` profile URL
`person.id`	positive integer	—	Numeric person ID accepted by Superdata; the dot is part of the parameter name
`user_id`	positive integer	—	LinkedIn user ID
`profile_id`	positive integer	—	LinkedIn profile ID
`strategy`	enum	`cached`	`cached`, `fetch`, `strict`, or `besteffort`
`maxage`	positive integer	—	Maximum cache age in seconds for `strict` or `besteffort`
`experience_filter`	enum	`default`	`default`, `current`, `revisions`, or `distincts`
`education_filter`	enum	`default`	`default`, `current`, `revisions`, or `distincts`
`summary_filter`	enum	`default`	`default` or `last_complete`

Example request

curl --request GET \
  --url 'https://api.superdata.so/v1/profile' \
  --get \
  --data-urlencode 'url=https://www.linkedin.com/in/satyanadella' \
  --data-urlencode 'strategy=cached' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

Example response

Provider fields can vary by profile. The data object below is representative; fields may be absent or null when they are not publicly available.

{
  "request_id": "req_01J...",
  "data": {
    "first_name": "Satya",
    "last_name": "Nadella",
    "headline": "Chairman and Chief Executive Officer at Microsoft",
    "location": "Redmond, Washington, United States",
    "experience": [],
    "education": []
  },
  "meta": {
    "source": "linkedin",
    "cached": true,
    "credits_used": 1
  }
}

Filtering history

default returns the provider’s standard representation.
current keeps current records.
revisions returns available record revisions.
distincts returns distinct historical records.
summary_filter=last_complete requests the latest complete summary.

See errors and limits for status codes and retry guidance.