search_jobs
Read-onlyIdempotent
Search official-source job evidence. Company is a URI from get_company_coverage.
Location filters describe desired job locations, never the user's personal location.
Do not infer or request the user's current location. Use only their explicit job-search criteria.
Use scope=global for locations outside the US; country uses its canonical full name.
Fresh-only results were observed within seven days, not necessarily posted then.
Known closed or not-yet-open application windows are excluded from fresh-only results.
Unknown application deadlines do not prove applications remain open.
Observed listings, including older observations, are returned by default; preserve warnings.
Set fresh_only=true when the user requests recently verified inventories.
posted_after is an employer publication date, YYYY-MM-DD. Unknown dates do not match.
Salary filters require currency and period (YEAR, MONTH, WEEK, DAY, HOUR); matching ranges
overlap the requested range, so the salary floor is not guaranteed. Limit is at most 100.
Remote does not mean worldwide eligibility. Cite official_url; never invent missing fields.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| sort | No | relevance | |
| limit | No | ||
| query | No | ||
| scope | No | global | |
| offset | No | ||
| region | No | ||
| company | No | ||
| country | No | ||
| seniority | No | ||
| work_mode | No | ||
| fresh_only | No | ||
| pay_period | No | ||
| pay_maximum | No | ||
| pay_minimum | No | ||
| pay_currency | No | ||
| posted_after | No | ||
| employment_type | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||