AI analysis

POST /market/coverage Session or API key

Score a supplied skill list against the filtered job market.

Stateless sibling of the CV verdict: skills come from the request body, the market from the facet query params (same vocabulary as search; the skills facet is ignored as a filter). Reports how many of the role’s vacancies your skills cover and which missing skill unlocks the most. 400 on empty skills, 503 when search is unavailable.

Query parameters

(any search filter) string
Any search facet param scopes the market (the skills facet is ignored here).Example category=backend

Body

skills string[] required
The skill list to score (max 100).Example ["go","postgresql"]
curl 
curl -X POST "https://freehire.dev/api/v1/market/coverage?category=backend" \
  -H "Authorization: Bearer $FREEHIRE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"skills":["go","postgresql"]}'
json — response 
{
  "data": {
    "total": 1820,
    "covered": 1400,
    "coverage_percent": 77,
    "gaps": [ { "name": "kubernetes", "new_vacancies": 120, "unlock_percent": 7 } ],
    "skills": [ { "name": "go", "market_frequency": 61, "must_have": true, "status": "strong", "advice": "" } ],
    "must_have_total": 8,
    "must_have_covered": 6,
    "stack_match_percent": 75,
    "bundles": [ { "...": "..." } ]
  }
}