> ## 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 Occupation Taxonomy

> Autocomplete occupation taxonomy values for Job Search.

# Job Search Occupation Taxonomy

Occupation taxonomy autocomplete for [Job Search](/docs/v1/reference/job-search). The taxonomy is a broad-to-specific hierarchy that maps free-text occupation queries to canonical IDs and labels.

| Level    | Meaning                 | Example           |
| -------- | ----------------------- | ----------------- |
| `level1` | Broad occupation family | "Engineer"        |
| `level2` | Occupation category     | "DevOps"          |
| `level3` | Normalized job title    | "DevOps Engineer" |

## Endpoint Details

<Tabs>
  <Tab title="Pricing" icon="coins">
    | Metric   | Value                            |
    | -------- | -------------------------------- |
    | **Cost** | **FREE** — 0 credits per request |

    <Tip>
      Occupation taxonomy autocomplete is free. Use this for filter-builder UIs that need a structured taxonomy picker.
    </Tip>
  </Tab>

  <Tab title="Rate Limits" icon="gauge">
    | Metric              | Value               |
    | ------------------- | ------------------- |
    | **Requests/Minute** | 300                 |
    | **Burst Capacity**  | \~5 requests/second |

    <Info>
      Rate limits are subject to change. Contact us for enterprise plans — [support@leadmagic.io](mailto:support@leadmagic.io).
    </Info>
  </Tab>
</Tabs>

***

## Quick Example

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl 'https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy?q=DevOps&level=level2&limit=10' \
    -H 'X-API-Key: YOUR_API_KEY'
  ```

  ```javascript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const url = new URL('https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy');
  url.searchParams.set('q', 'DevOps');
  url.searchParams.set('level', 'level2');
  url.searchParams.set('limit', '10');

  const response = await fetch(url, {
    headers: { 'X-API-Key': 'YOUR_API_KEY' }
  });
  const data = await response.json();
  console.log(data.occupation_taxonomy);
  ```

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

  response = requests.get(
      'https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy',
      headers={'X-API-Key': 'YOUR_API_KEY'},
      params={'q': 'DevOps', 'level': 'level2', 'limit': 10}
  )
  data = response.json()
  print(data['occupation_taxonomy'])
  ```
</CodeGroup>

***

## Request Parameters

<ParamField query="q" type="string">
  Free-text occupation query.
</ParamField>

<ParamField query="level" type="string">
  Restrict results to a single level. One of `level1`, `level2`, or `level3`. Omit to return matches across all levels.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  Number of taxonomy entries to return.
</ParamField>

***

## Response

<ResponseField name="occupation_taxonomy" type="object[]">
  Matching taxonomy entries with `id`, `name`, level metadata, and a human-readable `path`.
</ResponseField>

<ResponseField name="credits_consumed" type="number">
  Always `0` for this helper.
</ResponseField>

### Example Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "occupation_taxonomy": [
    {
      "id": 1700834,
      "name": ".NET & DevOps",
      "type": 2,
      "level1": { "id": 7, "name": "Engineer" },
      "level2": { "id": 1700834, "name": ".NET & DevOps" },
      "level3": null,
      "path": "Engineer > .NET & DevOps"
    }
  ],
  "credits_consumed": 0
}
```

***

## Related endpoints

<CardGroup cols={2}>
  <Card title="Job Search" icon="briefcase" href="/docs/v1/reference/job-search">
    Pass `occupationTaxonomy.level1/2/3` arrays into search.
  </Card>

  <Card title="Job Search Titles" icon="briefcase" href="/docs/v1/reference/job-search-titles">
    Find specific job titles within a taxonomy branch.
  </Card>

  <Card title="Job Search Tags" icon="tag" href="/docs/v1/reference/job-search-tags">
    Tags often map to taxonomy nodes — pair them in filter builders.
  </Card>

  <Card title="Job Search Helpers" icon="wand-magic-sparkles" href="/docs/v1/reference/job-search-helpers">
    Index of all filter helpers.
  </Card>
</CardGroup>


## OpenAPI

````yaml get /v3/jobs/search/occupation-taxonomy
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/occupation-taxonomy:
    get:
      tags:
        - Jobs Data
      summary: Job Search Occupation Taxonomy Helper
      description: >-
        Occupation taxonomy autocomplete with level1, level2, and level3 IDs and
        labels.
      operationId: job-search-occupation-taxonomy
      parameters:
        - name: q
          in: query
          example: DevOps
          schema:
            type: string
        - name: level
          in: query
          example: level2
          schema:
            type: string
            enum:
              - level1
              - level2
              - level3
        - name: limit
          in: query
          example: 10
          schema:
            type: integer
            default: 10
      responses:
        '200':
          description: Occupation taxonomy helper results
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).

````