> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Forager Job Search: Inputs, Cost & CLI Example
> Job post event search. Forager Forager Job Search docs include request fields, response shape, pricing notes, and Deepline CLI examples.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=forager_job_search:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ----------------------------- | --------------------------------------- | -------- | ------- | ------------------------------------------------------------------------ |
| `payload.page` | `integer` | No | | |
| `payload.job_source` | `"indeed" \| "linkedin" \| "angellist"` | No | | \* `indeed` - Indeed \* `linkedin` - LinkedIn \* `angellist` - AngelList |
| `payload.date_featured_start` | `string` | No | | |
| `payload.date_featured_end` | `string` | No | | |
| `payload.organization_ids` | `array` | No | | To get a list of IDs use Organizations lookup endpoint . |
| `payload.title` | `string` | No | | This field supports a boolean text search query. |
| `payload.description` | `string` | No | | This field supports a boolean text search query. |
| `payload.is_remote` | `boolean` | No | | |
| `payload.is_active` | `boolean` | No | `true` | |
| `payload.locations` | `array` | No | | To get a list of IDs use Locations lookup endpoint . |
| `payload.locations_exclude` | `array` | No | | To get a list of IDs use Locations lookup endpoint . |
### Allowed values
| Field | Allowed values |
| -------------------- | --------------------------------- |
| `payload.job_source` | `indeed`, `linkedin`, `angellist` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "JobPostEvent search request serializer.",
"properties": {
"page": {
"type": "integer"
},
"job_source": {
"type": "string",
"description": "* `indeed` - Indeed * `linkedin` - LinkedIn * `angellist` - AngelList",
"enum": [
"indeed",
"linkedin",
"angellist"
]
},
"date_featured_start": {
"type": "string",
"format": "date"
},
"date_featured_end": {
"type": "string",
"format": "date"
},
"organization_ids": {
"type": "array",
"description": "To get a list of IDs use Organizations lookup endpoint .",
"items": {
"type": "integer"
}
},
"title": {
"type": "string",
"description": "This field supports a boolean text search query."
},
"description": {
"type": "string",
"description": "This field supports a boolean text search query."
},
"is_remote": {
"type": [
"boolean",
"null"
]
},
"is_active": {
"type": "boolean",
"default": true
},
"locations": {
"type": "array",
"description": "To get a list of IDs use Locations lookup endpoint .",
"items": {
"type": "integer"
}
},
"locations_exclude": {
"type": "array",
"description": "To get a list of IDs use Locations lookup endpoint .",
"items": {
"type": "integer"
}
}
},
"required": [],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------------- |
| `result.data` | `object` | Yes | | OrganizationJobPostEvent search response serializer. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "OrganizationJobPostEvent search response serializer.",
"properties": {
"search_results": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the OrganizationJobPostEvent model for Jobs search API.",
"properties": {
"id": {
"type": "integer"
},
"source": {
"type": "string",
"description": "* `indeed` - Indeed * `linkedin` - LinkedIn * `angellist` - AngelList",
"enum": [
"indeed",
"linkedin",
"angellist"
]
},
"date_featured": {
"type": "string",
"format": "date"
},
"organization": {
"type": "object",
"description": "Short serializer for the Organization model.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"domain": {
"type": [
"string",
"null"
],
"maxLength": 200,
"format": "uri"
},
"linkedin_info": {
"type": "object",
"description": "Serializer for the OrganizationLinkedinInfo model.",
"properties": {
"public_identifier": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"industry": {
"type": "object",
"description": "Serializer for the LinkedinIndustry document.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"public_profile_url": {
"type": [
"string",
"null"
],
"description": "Get LinkedIn public profile URL."
}
},
"required": [
"industry",
"public_profile_url"
],
"additionalProperties": false
}
},
"required": [
"id",
"linkedin_info",
"name"
],
"additionalProperties": false
},
"source_id": {
"type": "string",
"maxLength": 65
},
"url": {
"type": "string",
"maxLength": 510,
"format": "uri"
},
"title": {
"type": "string",
"maxLength": 255
},
"description": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"location": {
"type": "object",
"description": "Serializer for the InnerLocation model for Jobs search API.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"osm_locations": {
"type": "array",
"items": {
"type": "object",
"description": "Serializer for the OSMLocation model for Jobs search API.",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 255
},
"place_type": {
"type": "string",
"maxLength": 255
}
},
"required": [
"id",
"name",
"place_type"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"osm_locations"
],
"additionalProperties": false
},
"is_active": {
"type": "boolean"
}
},
"required": [
"date_featured",
"id",
"is_active",
"is_remote",
"location",
"organization",
"source",
"source_id",
"title",
"url"
],
"additionalProperties": false
}
},
"total_search_results": {
"type": "integer",
"minimum": 0
}
},
"required": [
"search_results",
"total_search_results"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute forager_job_search --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `per_page` (per page).
* Estimated Deepline credits: `0.63` per pricing unit.
* Billing mode: `post_deduct`.