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

# Job Search Catalogs

> Fetch filter catalogs and dimension summaries for Job Search.

# Job Search Catalogs

Fetch the full set of filter catalogs for [Job Search](https://leadmagic.io/docs/v1/reference/job-search.md) — countries, regions, job types, industries, company types, seniority values, and dataset stats — in one call. Use this to populate static filter dropdowns in your UI.

## Endpoint Details

> [tab] Pricing
>
> | Metric | Value |
> | - | - |
> | **Cost** | **FREE** — 0 credits per request |
>
> > [!TIP]
> >
> > Cache the catalog response on your side — these dimensions change infrequently. Refresh on a daily or weekly schedule.

> [tab] Rate Limits
>
> | Metric | Value |
> | - | - |
> | **Requests/Minute** | 300 |
> | **Burst Capacity** | \~5 requests/second |
>
> > [!NOTE]
> >
> > Rate limits are subject to change. Contact us for enterprise plans — [support@leadmagic.io](mailto:support@leadmagic.io).

***

## Quick Example

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl 'https://api.leadmagic.io/v3/jobs/search/catalogs' \
  -H 'X-API-Key: YOUR_API_KEY'
```

```javascript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await fetch('https://api.leadmagic.io/v3/jobs/search/catalogs', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const catalogs = await response.json();
console.log(Object.keys(catalogs));
// ['countries', 'regions', 'job_types', 'industries', 'company_types', 'seniority', 'stats']
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import requests

response = requests.get(
    'https://api.leadmagic.io/v3/jobs/search/catalogs',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
catalogs = response.json()
print(list(catalogs.keys()))
```

***

## Request Parameters

This endpoint takes no parameters.

***

## Response

**countries** `object[]`

Country catalog with `id` and `name`.

**regions** `object[]`

Region catalog with `id` and `name`.

**job\_types** `object[]`

Job-type catalog (full-time, part-time, contract, etc.).

**industries** `object[]`

Industry catalog.

**company\_types** `object[]`

Company-type catalog (private, public, non-profit, etc.).

**seniority** `object[]`

Seniority catalog.

**stats** `object`

Public-safe Jobs Search coverage stats included with the catalog response.

### Example Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "countries": [
    { "id": 840, "name": "United States" },
    { "id": 826, "name": "United Kingdom" }
  ],
  "job_types": [
    { "id": 1, "name": "Full-time" },
    { "id": 2, "name": "Part-time" },
    { "id": 3, "name": "Contract" }
  ],
  "industries": [
    { "id": 96, "name": "Software" }
  ],
  "company_types": [
    { "id": 1, "name": "Private" },
    { "id": 2, "name": "Public" }
  ],
  "seniority": [
    { "id": 1, "name": "Entry" },
    { "id": 5, "name": "VP" }
  ],
  "stats": {
    "total_jobs_indexed": 12500000,
    "freshness_days": 1
  }
}
```

***

## Related endpoints

> [card] [Job Search Locations](https://leadmagic.io/docs/v1/reference/job-search-locations.md)
>
> Search location filters (states, cities) not in the static catalog.

> [card] [Job Search](https://leadmagic.io/docs/v1/reference/job-search.md)
>
> Use catalog IDs in `jobTypeIds`, `industryIds`, `companyTypeIds`, etc.

> [card] [Job Search Helpers](https://leadmagic.io/docs/v1/reference/job-search-helpers.md)
>
> Index of all filter helpers.


## OpenAPI

````yaml get /v3/jobs/search/catalogs
openapi: 3.1.0
info:
  title: LeadMagic API
  version: 1.4.34
  description: >
    # LeadMagic API Documentation


    The LeadMagic API provides comprehensive B2B data enrichment services
    including email validation, email finding, profile search, company
    intelligence, and more.


    ## Quick Start


    1. Get your API key from the [LeadMagic Dashboard](https://app.leadmagic.io)

    2. Add the `X-API-Key` header to all requests

    3. Start enriching your data!


    ## Base URL


    All API requests should be made to: `https://api.leadmagic.io`


    ## Rate Limits


    Each endpoint has specific rate limits (requests per minute). Exceeding
    limits returns a `429 Too Many Requests` response.


    ## Credits


    API calls consume credits based on the endpoint used. Check your balance
    with the `/v1/credits` endpoint.


    ## Support


    Contact us at support@leadmagic.io for assistance.
  contact:
    name: LeadMagic Support
    email: support@leadmagic.io
    url: https://leadmagic.io
  termsOfService: https://leadmagic.io/legal/terms
servers:
  - url: https://api.leadmagic.io
    description: Production API Server
security:
  - ApiKeyAuth: []
tags:
  - name: Credits
    description: Manage and check your credit balance
  - name: Analytics
    description: >-
      Monitor your API usage with comprehensive analytics endpoints (FREE - no
      credits consumed)
  - name: People Enrichment
    description: Find and validate contact information for individuals
  - name: Company Data
    description: Discover company information and intelligence
  - name: Jobs Data
    description: Search job listings and detect career changes
  - name: Ads Data
    description: Search advertising data across platforms
paths:
  /v3/jobs/search/catalogs:
    get:
      tags:
        - Jobs Data
      summary: Job Search Catalogs
      description: >-
        Filter catalogs for countries, regions, job types, industries, company
        types, seniority, and public-safe Jobs Search stats.
      operationId: job-search-catalogs
      responses:
        '200':
          description: Catalog response
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your LeadMagic API key. Header name is case-insensitive (X-API-Key,
        X-API-KEY, x-api-key all work).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.