> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superdata.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Profile API

> Retrieve a LinkedIn profile by URL or numeric identifier.

## Get a profile

```http theme={null}
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](/reference/authentication).

## 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

```bash theme={null}
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.

```json theme={null}
{
  "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](/reference/errors-and-limits) for status codes and retry guidance.