AGagentkey
jobs

Search job postings by keyword and location. Returns a normalized Job page.

Keyword job search. country=CN routes to Liepin (Chinese job board, Chinese keywords); every other country to JSearch (Google for Jobs aggregate). Filters a provider cannot express skip that provider instead of being dropped.

Fixed price: 0.4 credits per successful call, whichever provider serves it.

post/v2/ops/jobs.search

Request

  • Base URL
    https://api.agentkey.app
  • URL
    https://api.agentkey.app/v2/ops/jobs.search
  • Auth
    HTTP bearer

Request body

countrystring

ISO 3166-1 alpha-2 country of the job market. CN routes to Liepin; every other country to JSearch.

cursorstring

Opaque pagination cursor from the previous response's next_cursor. Send the same query parameters with it.

employment_type'full_time' | 'part_time' | 'contract' | 'internship'

Restrict to one employment type.

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

limitinteger

Maximum number of results to return.

locationstring

City or region to search in, e.g. San Francisco, CA / 上海.

providerstring

Shorthand for routing.only = [provider].

querystring required

Job title / keywords, e.g. software engineer, 软件工程师.

remoteboolean

Only remote / work-from-home jobs.

time_range'day' | 'week' | 'month' | 'all'

Only postings published within this window.

Response

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown
raw_truncatedboolean
request_idstring required

Correlation id; quote it in support requests.

took_msinteger required
unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

Changes

No recorded changes to this operation across all 1 revision of this API.