search_jobs
Flat, role-granular job search -- the individual open roles across
companies matching role (function) / geo (country) / since, one
row per logical req (each with its own company_id + req_key),
ATS-only + freshness-floored. Keyset-paginated via the opaque cursor
(a prior call's next_cursor). Use who_is_hiring_for for the
company-granular reverse view. role must be a function id (as seen
in prior results); a plain role name like 'engineering' is rejected
with an explicit error rather than an empty result -- pass plain
language as q instead, which searches the posting's own title,
expanded semantically to nearby titles, and reports each row's
relevance (0-1). q is independent of role: pass both to search
titles within one function. sort is 'relevance' (the default with a
q) or 'recency'; omit both and the page keeps its stable default
order. limit is bounded: an oversized page is rejected rather than
truncated, so page through the full set with cursor instead of
raising limit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| geo | No | ||
| role | No | ||
| sort | No | ||
| limit | No | ||
| since | No | ||
| cursor | No | ||
| plane_api_key | No | ||
| idempotency_key | No |