Careerjet Job Search API
✓ Official Vendor SpecHR recruitingRecruiting Atsbasic1 EndpointsREST
For Agents
Search millions of job listings across 90+ countries by keyword, location, contract type, and hours via a single GET /query endpoint.
Use for: Search for software engineer jobs in London, Find remote part-time data analyst roles, List the most recent permanent contract jobs in Berlin, I want to retrieve full-time contract positions in Dublin
Not supported: Does not handle applicant tracking, candidate sourcing databases, or job posting submission - use for searching aggregated public job listings only.
Careerjet Job Search API is the partner search interface to Careerjet's global job listings index, covering millions of postings aggregated from employers and job boards across 90+ countries. It exposes a single GET /query endpoint that accepts keyword, location, contract type, contract period, sort order, and pagination parameters and returns a structured list of matched jobs. Authentication uses HTTP basic auth with an API key as the username.
Install Jentic One Beta
Connect the Careerjet Job Search API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Careerjet Job Search API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcareerjet.net%2Fcareerjet" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcareerjet.net%2Fcareerjet" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Careerjet Job Search API.
Search Careerjet's aggregated job index by keyword and location
Filter results by contract type (permanent, contract, temporary, traineeship, voluntary)
Filter results by contract period (full time, part time)
Page through large result sets using page and pagesize parameters
Sort matched jobs by relevance, date, or salary
Return localized results by setting locale_code (e.g., en_GB, fr_FR, de_DE)
Use Cases
Patterns agents use Careerjet Job Search API for, with concrete tasks.
★ Job Aggregator or Talent Marketplace
Power a job board or talent marketplace by feeding Careerjet's aggregated index into search results. GET /query takes a keyword, location, and pagination parameters and returns matched job records with title, company, location, salary, and source URL. Filters for contract type and period make it possible to surface only the listings relevant to a candidate's preferences.
Search for 'software engineer' in 'London, UK' with contracttype=p and pagesize=20, then return the top three results.
Recruiter Sourcing Assistant
Drive a recruiter assistant that finds matching job postings to benchmark salary, demand, and location distribution. The single search endpoint accepts keywords, locale, and sort order, so an agent can run multiple targeted queries and aggregate results into a hiring-market snapshot for a given role.
Run three Careerjet queries for 'data scientist' in London, Berlin, and Dublin, sort by date, and return the count of results in each city.
Career-Aware Chatbot or Notification Service
Send candidates a daily digest of newly posted jobs matching saved searches. By calling GET /query with sort=date, page=1, and stored keyword/location pairs each morning, an agent can produce a personalised list to send via email or chat. Pagination plus the date sort makes it cheap to detect what is genuinely new since the last run.
For each saved search, fetch the first page sorted by date and email the user any results not seen in yesterday's run.
AI Agent Job Search via Jentic
Plug Careerjet into an agent through Jentic so a natural-language request like 'find me remote part-time analyst jobs in Spain' becomes a single search call. Jentic returns the GET /query operation schema, holds the API key in its vault, and emits a structured job list the agent can summarise or rank.
Through Jentic, search for 'analyst' in 'Madrid, Spain' with contractperiod=p (part time) and return the top five jobs.
Key Endpoints
1 endpoints — careerjet job search api is the partner search interface to careerjet's global job listings index, covering millions of postings aggregated from employers and job boards across 90+ countries.
METHOD
PATH
DESCRIPTION
GET
/query
Search for jobs across the Careerjet aggregated index
GET
/query
Search for jobs across the Careerjet aggregated index
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Careerjet Job Search API by hand means passing your API key as the basic-auth username with an empty password on every call to the search.api.careerjet.net host yourself. Through Jentic you install once, import the Careerjet Job Search API from the API Directory, store the key once, and your agent calls it.
Permission scoping
Careerjet exposes a single search operation, so you scope by operation: limit the agent to the query search it needs, and it can do nothing beyond that call.
Credential isolation
Your Careerjet API key is stored once, encrypted, by your own Jentic One instance and injected as the basic-auth username at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'search for jobs by keyword and location', and Jentic returns the query operation with its input schema so the agent supplies the right parameters without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Careerjet Job Search API through Jentic.
What authentication does the Careerjet Job Search API use?
Careerjet uses HTTP basic authentication with the API key as the username and an empty password. Apply for a partner key on the Careerjet partners page. Through Jentic the API key is stored encrypted in the credential vault and injected into the Authorization header at request time, so the raw key never appears in agent logs.
How do I filter Careerjet results by contract type?
GET /query accepts a contracttype parameter with values such as p (permanent), c (contract), t (temporary), i (traineeship), and v (voluntary). Combine with contractperiod (f for full time, p for part time) to narrow results further.
How many countries does Careerjet cover?
Careerjet aggregates job listings from 90+ country sites. Pass a locale_code (for example, en_GB, fr_FR, de_DE, es_ES) to scope a search to a specific market and return localised result fields. The default locale is set on the partner key configuration.
How do I paginate through Careerjet search results?
Use the `page` and `pagesize` query parameters. The response includes the total number of matched jobs, so an agent can compute how many more pages remain and stop when the desired count is reached. Combined with sort=date, this is also how a daily-digest workflow detects new postings.
What are the rate limits for the Careerjet Job Search API?
The OpenAPI specification does not declare numeric rate limits. Careerjet enforces per-partner-key throttling at its gateway; if you receive 429 responses, slow your queries and consider caching on common search terms. Refer to the partner agreement issued with your API key for the limits attached to your account.
How do I search Careerjet through Jentic?
Run `pip install jentic`, then use Jentic's search to find the job-search operation with the query "search for jobs by keyword and location", load the schema, and execute with `{"keywords": "data scientist", "location": "London, UK"}`. Jentic calls GET /query with your API key from the vault and returns the structured job list.
Does the API include salary information?
Yes - when an underlying job source provides salary data, Careerjet surfaces it in the response. Coverage varies by country and source, so some results include explicit salary ranges while others do not. You can also pass sort=salary to rank results by salary where available.
Can I limit what my agent is allowed to do with the Careerjet Job Search API?
Yes. Because you run Jentic One yourself, you set the rules that decide which operations and credentials your agent may use. The Careerjet Job Search API exposes a single GET /query search operation, so you scope the agent to just that job-search call and nothing beyond it. Your API key is held by your own instance and injected as the basic-auth username at request time, so the agent never sees the raw credential.
GET STARTED