Skip to main content
POST
/
v3
/
search
/
stats
Search Stats
curl --request POST \
  --url https://api.leadmagic.io/v3/search/stats \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "products": [
    "jobs",
    "company",
    "people"
  ],
  "sections": [
    "coverage",
    "top"
  ],
  "limit": 10
}
'
{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/validation_error",
      "title": "Request validation failed. Check your input parameters.",
      "status": 400,
      "code": "validation_error",
      "param": [
        "email"
      ],
      "detail": "Email format is invalid. Expected format: user@domain.com",
      "action": "Provide a valid email address in the 'email' field.",
      "docs": "https://leadmagic.io/docs/api-reference/errors"
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Search Stats

POST /v3/search/stats is a free helper endpoint that summarizes what is available across Jobs, Company, and People Search. Use it to power filter builders, capability cards, onboarding screens, or “what can I target?” UI. The endpoint returns cached, high-level metrics only. It does not return records, contacts, or jobs.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v3/search/stats' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "products": ["jobs", "company", "people"],
    "sections": ["coverage", "top"],
    "limit": 3
  }'

​
Request Body

​
products
string[]
default:"[\"jobs\",\"company\",\"people\"]"
Product families to include. Allowed values: jobs, company, people.
​
sections
string[]
default:"[\"coverage\",\"top\",\"capabilities\"]"
Sections to include. Allowed values: coverage, top, capabilities.
​
limit
integer
default:"3"
Number of top values to return for each dimension. Defaults to 3; maximum is 25.

​
Request Examples

Coverage only: 
{
  "products": ["jobs", "company", "people"],
  "sections": ["coverage"]
}
Top company and people dimensions: 
{
  "products": ["company", "people"],
  "sections": ["top"],
  "limit": 3
}
Jobs capabilities and filter counts: 
{
  "products": ["jobs"],
  "sections": ["coverage", "capabilities", "top"]
}

​
Response

​
credits_consumed
number
Always 0.
​
jobs.coverage
object
Jobs coverage metrics such as open jobs, total indexed jobs, companies, and title embeddings.
​
jobs.capabilities
object
Supported Jobs Search capabilities and filter families.
​
jobs.top
object
Top jobs dimensions such as common titles, specialties, role families, industries, company types, and countries.
​
company.coverage
object
Company coverage metrics such as estimated companies, company records with technology data, and contact coverage rollups.
​
company.top
object
Top company dimensions such as industries, countries, regions, size ranges, revenue ranges, funding types, SIC/NAICS, and each technology category.
​
people.coverage
object
People/contact coverage metrics, including estimated contacts and email/phone availability rollups.
​
people.top
object
Top people/contact coverage dimensions by company.
​
cache
object
Cache status for each backend stats source.

Job Search

Search jobs using the capabilities shown here.

Company Search

Search companies using the company dimensions shown here.

People Search

Search contacts using the people coverage shown here.

Job Search Helpers

Resolve concrete filter values for Jobs Search.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Body

application/json
​
products
enum<string>[]
Available options:
jobs,
company,
people
​
sections
enum<string>[]
Available options:
coverage,
top,
capabilities
​
limit
integer
default:10
Required range: 1 <= x <= 25

Response

Search stats results