> ## Documentation Index
> Fetch the complete documentation index at: https://www.forager.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Search job postings data

> Search job post events in the Forager job-post index by title, remote status, location and date, and get totals for a query.

![Job postings data search: filters return a list of matching job posts](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/job-postings-data-search.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=8cfb3b21289bc9926086dacbb5c58b9f)

Use this to find job postings, for example to spot companies that are hiring for a role.

## Search

Send a `POST` to [Job post event search](https://www.forager.ai/docs/openapi/job-posts/datastorage_job_search_create.md). `title` and `description` support a boolean text search query.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/job_search/" \
     -H "X-API-KEY: $FORAGER_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "title": "Software Engineer",
           "is_remote": true,
           "is_active": true
         }'
```

Set `FORAGER_API_KEY` and `FORAGER_ACCOUNT_ID` in your shell first, as in the [quickstart](https://www.forager.ai/docs/api-overview/send-your-first-request.md). See [Authentication](https://www.forager.ai/docs/api-overview/authentication.md).

Other filters: `job_source`, `date_featured_start` / `date_featured_end`, `organization_ids`, `locations` and `locations_exclude`. IDs come from the [Autocomplete](https://www.forager.ai/docs/openapi/autocomplete) endpoints.

## Count first

[Job post event search totals](https://www.forager.ai/docs/openapi/job-posts/datastorage_job_search_totals_create.md) takes the same body and returns totals. Page through results with `page`.

## Costs

See [Credit pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md).


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