---
title: "Score up to 25 jobs or companies 0–100 against your criteria, with a reason each."
method: POST
path: "/v1/ai/score"
tags: ["AI functions"]
---

# Score up to 25 jobs or companies 0–100 against your criteria, with a reason each.

`POST /v1/ai/score`

## Request

- Base URL: `https://linkfetch.io`
- URL: `https://linkfetch.io/v1/ai/score`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Score up to 25 jobs or companies 0–100 against your criteria, with a reason each.

1 credit per request, however many rows come back.

MCP tool: `ai_score`.

## Request body

- object
  - `records` object[], required
    - `type` 'job' | 'company', required
    - `id` integer, required
  - `criteria` string, required

## Response `200`

OK

- AiResult
  - `data` object[]
    - `type` 'job' | 'company'
    - `id` integer
    - `name` string
    - `value` string: The score (as text), category, extracted fields or written text.
    - `detail` string, nullable: The reason, when there is one.

## Other responses

- `400`: Invalid input (`bad_request`).
- `401`: Missing, invalid or revoked API key (`unauthorized`).
- `402`: Out of credits (`out_of_credits`).
- `default`: Other errors: 409 account session needs attention, 428 no connected account (`no_account`), 501 not in the API yet (`coming_soon`), 502 LinkedIn failed (`upstream`), 503 `unavailable`, 500 `internal`.

---

[API](https://skmtc.dev/linkfetch/apis/linkfetch-api.md) · [All operations](https://skmtc.dev/linkfetch/apis/linkfetch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linkfetch/apis/linkfetch-api/revisions/b83d21f70fcb?raw)