> ## 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](https://leadmagic.io/docs/v1/reference/job-search.md). 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 > [tab] Pricing > > | 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. > [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/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']) ``` *** ## Request Parameters **q** `string` Free-text occupation query. **level** `string` Restrict results to a single level. One of `level1`, `level2`, or `level3`. Omit to return matches across all levels. **limit** `integer` (default: 10) Number of taxonomy entries to return. *** ## Response **occupation\_taxonomy** `object[]` Matching taxonomy entries with `id`, `name`, level metadata, and a human-readable `path`. **credits\_consumed** `number` Always `0` for this helper. ### 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 > [card] [Job Search](https://leadmagic.io/docs/v1/reference/job-search.md) > > Pass `occupationTaxonomy.level1/2/3` arrays into search. > [card] [Job Search Titles](https://leadmagic.io/docs/v1/reference/job-search-titles.md) > > Find specific job titles within a taxonomy branch. > [card] [Job Search Tags](https://leadmagic.io/docs/v1/reference/job-search-tags.md) > > Tags often map to taxonomy nodes — pair them in filter builders. > [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/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). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.