---
title: "Search jobs"
method: POST
path: "/enrichment/jobs/search"
tags: ["crm"]
---

# Search jobs

`POST /enrichment/jobs/search`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/enrichment/jobs/search`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Search job postings through Dench find. `companyDomains` takes up to 1000 domains (chunked automatically); `dench jobs find --company-list <id|view>` resolves a saved company list into it.

## Request body

- object
  - `titles` string[]: Job titles (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json.
  - `locations` string[]: Cities, states, countries, or metros (free text). Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json.
  - `companyDomain` string
  - `companyName` string
  - `companyLinkedinUrl` string
  - `keywords` string
  - `postedAfter` string
  - `postedBefore` string: Inclusive posting end date (YYYY-MM-DD); includes the whole UTC day.
  - `limit` integer
  - `pageToken` string: Opaque token from a previous response's metadata.nextPageToken.
  - `preferCache` boolean

## Response `200`

Successful response

- object
  - `source` 'live' | 'cache', required
  - `jobs` object[], required: Job postings in the canonical job_posting shape.
    - `title` string
    - `company` string
    - `location` string
    - `url` string
    - `workplaceType` string
    - `postedAt` string
  - `metadata` object
    - `total` number: Total matches for the search. Stable across pages; absent when only an estimate exists.
    - `totalIsEstimate` boolean: True when the total is a lower bound rather than exact.
    - `offset` number
    - `nextPageToken` string: Opaque token for the next page. Pass it back as pageToken; absent on the last page.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)