# Score from LinkedIn

> Score a company from its LinkedIn page, or from a person's LinkedIn profile (their current employer). 10 credits.

`POST https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/score/social`

| URL | Example | Company scored | Credits |
|---|---|---|---|
| **Company page** | `linkedin.com/company/stripe` | That company (its website, e.g. `stripe.com`) | **10** |
| **Person profile** | `linkedin.com/in/jane-doe` | The person's **current** employer | **10** |

`/company/`, `/school/` and `/showcase/` pages are company pages; `/in/` is a person. Any form works (`https://`, `www.`, trailing slash, query).

## Start

```bash
curl -X POST "https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/score/social" \
  -H "Authorization: Bearer $PLATINUX_API_KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/company/stripe/", "template_id": "4d286e65-…"}'
```

| Body field | Type | Required |
|---|---|---|
| `url` | string | Yes |
| `template_id` | string (UUID) | Yes |

### Company found, scoring started: `202`, 10 credits

```json
{ "status": "processing", "job_id": "8394d14a-…", "domain": "stripe.com", "template_id": "4d286e65-…",
  "check_after_seconds": 30, "input": "https://www.linkedin.com/company/stripe", "input_type": "linkedin_company", "credits_charged": 10 }
```

### No company found: `200`, 0 credits

```json
{ "status": "not_found", "input": "https://www.linkedin.com/in/someone", "input_type": "linkedin_person", "domain": null, "score": null, "credits_charged": 0 }
```

`input_type`: `linkedin_company` or `linkedin_person`.

## Check the score

```bash
curl "https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/score/domain?job_id=8184a513-…" -H "Authorization: Bearer $PLATINUX_API_KEY"
```

`202` while `processing`; `200` when finished. Check every `check_after_seconds` (30). Any of the three paths works for `GET`.

```json
{ "status": "complete", "job_id": "8184a513-…", "domain": "asana.com", "template_id": "4d286e65-…",
  "score": 100, "scored_at": "2026-11-19T14:48:49Z", "credits_charged": 10 }
```

`status` is `complete`, or `partial` when some data didn't arrive within 10 minutes (scored with what arrived).

## Errors

| HTTP | `error` | When |
|---|---|---|
| 400 | `invalid_url` | Not a LinkedIn company or person URL (`reason: not_linkedin`) |
| 400 | `invalid_domain` | The company's website was rejected ([Domain checks](/domain-checks)). Free |
| 401 | `unauthorized` | Missing, wrong or revoked key |
| 402 | `insufficient_credits` | Fewer than 10 credits |
| 403 / 409 / 422 | `template_not_allowed` / `template_not_live` / `template_empty` | Template problems |
| 502 | `provider_unavailable` | A data source didn't answer. Free; try again |
