Skip to main content
POST
Search jobs
Open jobs for job seekers to apply to, newest first. job_title (the role or skills) is required; location, country_code (default US), remote, job_type and posted_within_days (default 14 days, so only recent openings) narrow the search. There is no free preview: every call returns full postings at 1 credit each. Start with a small limit (default 10).

Search and continuation

Each new posting costs 1 credit; postings you already bought are free and counted in already_purchased. When has_more is true, send the same body with cursor set to next_cursor. A search’s results are kept for about a day, so pages and repeats are consistent; if a cursor has expired, start again without it. Each posting has apply_url, the employer’s own application page, when one is listed; otherwise apply through company.website.

Authorizations

Authorization
string
header
required

Enricho API key (enr_...)

Body

application/json

Send JSON with Content-Type: application/json.

job_title
string
required

The role or skills to search, e.g. full stack developer or react. Required.

Required string length: 1 - 200
location
string

City, state or region within the country, e.g. Austin, TX. Omit for the whole country.

Maximum string length: 200
country_code
string
default:US

ISO 3166-1 alpha-2 country to search. Unsupported countries return 422.

Pattern: ^[A-Za-z]{2}$
remote
enum<string>

Only remote or hybrid roles.

Available options:
remote,
hybrid
job_type
enum<string>

Employment type.

Available options:
fulltime,
parttime,
contract,
temporary,
internship
posted_within_days
enum<integer>
default:14

Only postings from the last 1, 3, 7 or 14 days (default 14). Older postings are never returned.

Available options:
1,
3,
7,
14
limit
integer
default:10

Postings to return, 1–100, at 1 credit each. Omitted or 0 uses 10.

Required range: 0 <= x <= 100
cursor
string

Opaque next_cursor from the previous full page of the same search. Keep every other field identical.

Response

Success envelope.

success
boolean
required
result
object
required

No total_estimate or total_capped fields are returned by public search.

message
string
required