---
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

---

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