# Enrich People

Get the full LinkedIn profile of up to 25 people, optionally with a work email.

Fetches each profile live from LinkedIn: current and past positions, education, skills, languages and certifications. Send up to 25 URLs per call; each gets its own entry in `results`, in the order you sent them.

A profile that does not exist, or a URL that is not a LinkedIn profile, costs nothing. With `include_email`, we also look for a work email (name and company domain, checked over SMTP) — if we only find a personal address, you get that one instead.

Calls with many profiles take a while: count on about 5 seconds per profile, spread over parallel lookups. Set your HTTP timeout to at least 120 seconds.

## Request

```http
POST https://geteem.com/api/v1/person/enrich
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

### Body parameters

- **`profile_urls`** `string[]` · **required** — 1 to 25 LinkedIn profile URLs, e.g. `https://www.linkedin.com/in/jane-example`. The member-id form that Search People returns works too.
- **`include_email`** `boolean` — Also look for an email address. Adds 10 credit per address found. Defaults to false.

## Response

- **`results`** `object[]` — One entry per URL you sent, in the same order.
- **`results[].input`** `string` — The URL as you sent it.
- **`results[].status`** `string` — `matched`, `not_found` (no such profile), `invalid_url` (not a LinkedIn profile URL) or `error` (lookup failed; retry later). One of: `matched`, `not_found`, `invalid_url`, `error`.
- **`results[].person`** `object | null` — The profile when the status is `matched`, otherwise null. See the fields below.
- **`person.linkedin_url`** `string` — Public profile URL.
- **`person.linkedin_id`** `string | null` — LinkedIn member id.
- **`person.public_identifier`** `string | null` — The slug in the profile URL.
- **`person.first_name / last_name / full_name`** `string | null` — Name.
- **`person.headline`** `string | null` — Headline under the name.
- **`person.about`** `string | null` — The About section.
- **`person.location`** `object` — `text` as LinkedIn shows it, plus `city`, `state`, `country` and `country_code` (ISO 3166-1 alpha-2) when known.
- **`person.picture_url`** `string | null` — Profile photo. LinkedIn photo URLs expire after a few weeks.
- **`person.connections_count / follower_count`** `integer | null` — Network size.
- **`person.open_to_work / hiring / premium`** `boolean | null` — Profile badges.
- **`person.current_positions`** `object[]` — The entries of `experience` that are still ongoing.
- **`person.experience`** `object[]` — Positions, newest first: `title`, `company_name`, `company_linkedin_url`, `location`, `employment_type`, `workplace_type`, `start_date` and `end_date` (`year`, `month`; `end_date` is null while ongoing), `is_current`, `duration`, `description`.
- **`person.education`** `object[]` — `school_name`, `school_linkedin_url`, `degree`, `field_of_study`, `start_date`, `end_date`, `description`.
- **`person.skills`** `string[]` — Skills, top skills first.
- **`person.languages`** `object[]` — `name` and `proficiency`.
- **`person.certifications`** `object[]` — `name`, `issued_by`, `issued_at`.
- **`person.email`** `object | null` — Only with `include_email`: `address`, `type` (`work` or `personal`), `deliverable` and `catch_all` (booleans from the SMTP check; null when unknown) and `quality_score`. Null when nothing was found.
- **`credits_used`** `integer` — Credits this call used.

## Credits

2 credits per profile found, +10 per email found. Errors and empty lookups are free. The cost of every call is in `credits_used` and in the `X-Credits-Used` header.

## Errors

- **400** `invalid_request` — The body is not valid JSON, a field is unknown or has the wrong type, or a value is not allowed.
- **401** `authentication_error` — The Authorization header is missing, or the key is unknown or revoked.
- **403** `permission_error` — API access is not part of your plan, or your account is suspended.
- **429** `rate_limit_error` — More than 60 requests per minute, or more than 3 at the same time, on one key. Wait for the Retry-After header.
- **429** `daily_limit_reached` — The request could take your organization over its daily credit limit. The limit resets at midnight (Europe/Brussels).
- **502** `upstream_error` — The data source did not answer. Retry later.
- **503** `service_unavailable` — The API is temporarily unavailable. Retry later.
- **500** `internal_error` — Something went wrong on our side.

## Example

### Example request

```bash
curl -X POST "https://geteem.com/api/v1/person/enrich" \
  -H "Authorization: Bearer $SIMBA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_urls": [
      "https://www.linkedin.com/in/jane-example",
      "https://www.linkedin.com/in/does-not-exist-123"
    ],
    "include_email": true
  }'
```

### Example response

```json
{
  "results": [
    {
      "input": "https://www.linkedin.com/in/jane-example",
      "status": "matched",
      "person": {
        "linkedin_url": "https://www.linkedin.com/in/jane-example",
        "linkedin_id": "ACwAAExample123",
        "public_identifier": "jane-example",
        "first_name": "Jane",
        "last_name": "Example",
        "full_name": "Jane Example",
        "headline": "CFO at Acme Analytics",
        "about": null,
        "location": {
          "text": "Ghent, Flemish Region, Belgium",
          "city": "Ghent",
          "state": "Flemish Region",
          "country": "Belgium",
          "country_code": "BE"
        },
        "picture_url": null,
        "connections_count": 500,
        "follower_count": 1204,
        "open_to_work": false,
        "hiring": false,
        "premium": true,
        "current_positions": [
          {
            "title": "Chief Financial Officer",
            "company_name": "Acme Analytics",
            "company_linkedin_url": "https://www.linkedin.com/company/acme-analytics",
            "location": "Ghent, Belgium",
            "employment_type": "Full-time",
            "workplace_type": "Hybrid",
            "start_date": {
              "year": 2026,
              "month": 7
            },
            "end_date": null,
            "is_current": true,
            "duration": "3 mos",
            "description": null
          }
        ],
        "experience": [
          {
            "title": "Chief Financial Officer",
            "company_name": "Acme Analytics",
            "company_linkedin_url": "https://www.linkedin.com/company/acme-analytics",
            "location": "Ghent, Belgium",
            "employment_type": "Full-time",
            "workplace_type": "Hybrid",
            "start_date": {
              "year": 2026,
              "month": 7
            },
            "end_date": null,
            "is_current": true,
            "duration": "3 mos",
            "description": null
          }
        ],
        "education": [
          {
            "school_name": "Ghent University",
            "school_linkedin_url": null,
            "degree": "Master of Science",
            "field_of_study": "Business Economics",
            "start_date": {
              "year": 2008,
              "month": null
            },
            "end_date": {
              "year": 2012,
              "month": null
            },
            "description": null
          }
        ],
        "skills": [
          "Financial Planning",
          "M&A"
        ],
        "languages": [
          {
            "name": "Dutch",
            "proficiency": "Native or bilingual proficiency"
          }
        ],
        "certifications": [],
        "email": {
          "address": "jane@acme-analytics.example",
          "type": "work",
          "deliverable": true,
          "catch_all": false,
          "quality_score": 95
        }
      }
    },
    {
      "input": "https://www.linkedin.com/in/does-not-exist-123",
      "status": "not_found",
      "person": null
    }
  ],
  "credits_used": 2
}
```