---
title: "Search Stats"
method: POST
path: "/v3/search/stats"
tags: ["Jobs Data", "Company Data", "People Enrichment"]
---

# Search Stats

`POST /v3/search/stats`

Free helper endpoint that returns cached high-level coverage, capabilities, and top dimensions for Jobs, Company, and People Search.

## Request body

- object
  - `products` string[] — Search products to include — jobs, company, and/or people stats.
  - `sections` string[] — Stat sections to return — coverage counts, top dimensions, and/or filter capabilities.
  - `limit` integer — Max top values per dimension. Defaults to 3.

## Response `200`

Search stats results

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets

## Changes

- **2026-08-25** `1f289eff3a26` — 4 breaking
  - the `allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `400`
  - the `allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `429`
  - the `oneOf[#/components/schemas/InvalidApiKeyError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `401`
  - the `oneOf[#/components/schemas/MissingAuthenticationError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property type/format changed from `string`/`uri` to `string`/`uri-reference` for status `401`
- **2026-08-05** `08b59585eeb7` — 1 info
  - the `limit` request property default value changed from `10` to `3`

[Change history](https://skmtc.dev/leadmagic/apis/leadmagic-api/changes/v3/search/stats/post.md)

---

[API](https://skmtc.dev/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.dev/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/1f289eff3a26/schema)