---
title: "Search Jobs"
method: POST
path: "/v2/jobs/search"
tags: ["Job Search"]
---

# Search Jobs

`POST /v2/jobs/search`

Search job postings across companies by job attributes, location, and company firmographics.

## Request body

- object
  - `job` object — Job-level search criteria
    - `title` object — Keywords matched against the job title only (strict role search)
      - `include` string[]
      - `exclude` string[]
    - `description` object — Keywords matched against the job description content
      - `include` string[]
      - `exclude` string[]
    - `ai_keywords` object — Broad theme search across title, description, skills, responsibilities, requirements and taxonomies
      - `include` string[]
      - `exclude` string[]
    - `field` object — The job's professional field or discipline (e.g. Software Engineering, Sales, Finance). Free-form — accepts any field label.
      - `include` string[]
      - `exclude` string[]
    - `seniority` object — The role's seniority, expressed as bands of required years of experience (0-2, 2-5, 5-10, 10+ years).
      - `include` string[]
      - `exclude` string[]
    - `employment_type` object — The type of employment the job offers (full-time, part-time, contractor, temporary, intern, etc.).
      - `include` string[]
      - `exclude` string[]
    - `work_arrangement` object — Where the work is performed — on-site, hybrid, or remote.
      - `include` string[]
      - `exclude` string[]
    - `location` object — Job location (not company HQ).
      - `city` object — Job location city (exact, case/accent-insensitive)
        - `include` string[]
        - `exclude` string[]
      - `country_code` object — Exact matches (ISO-3166 alpha-2) on the job location country
        - `include` string[]
        - `exclude` string[]
    - `date_posted` object — Only jobs posted within the last N days
      - `last_days` integer
  - `company` object — Company-level firmographic criteria (enriched from the internal company record)
    - `is_agency` boolean, nullable — true = only recruitment/staffing agencies, false = exclude confirmed agencies, null/omitted = both
    - `industry` object — Exact matches on the enriched company's LinkedIn industry
      - `include` string[]
      - `exclude` string[]
    - `employee_count` object — Range search on the enriched company's LinkedIn headcount. 0 = unset.
      - `min` number
      - `max` number
    - `size` object — Exact matches on the enriched company's LinkedIn size bucket
      - `include` string[]
    - `keywords` object — Keywords matched against the enriched company positioning / firmographic text
      - `include` string[]
      - `exclude` string[]
    - `hq` object — Company headquarters (not job location)
      - `city` object — Keywords matched against the enriched company HQ city
        - `include` string[]
        - `exclude` string[]
      - `state` object — Keywords matched against the enriched company HQ state/region
        - `include` string[]
        - `exclude` string[]
      - `country_code` object — Exact matches (ISO-3166 alpha-2) on the enriched company HQ country code
        - `include` string[]
        - `exclude` string[]
  - `max_results` number — Maximum number of results to return
  - `cursor` string, nullable — Cursor to paginate through the results

## Response `200`

Response for status 200

- object
  - `total_results` number
  - `results` object[]
    - `date_posted` string, nullable
    - `title` string, nullable
    - `url` string, nullable
    - `company_name` string, nullable
    - `company_linkedin_url` string, nullable
    - `ai_summary` string, nullable
    - `location` object
      - `city` string, nullable
      - `country_code` string, nullable
  - `results_length` number
  - `max_results` number
  - `cursor` string, nullable

## Other responses

- `401` — Response for status 401
- `402` — Payment Required
- `429` — Response for status 429

---

[API](https://skmtc.dev/blitz-api/apis/blitz-api-reference.md) · [All operations](https://skmtc.dev/blitz-api/apis/blitz-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blitz-api/blitz-api-reference/revisions/ef6509a474f8/schema)