Careerjet Job Search API

Name: Careerjet Job Search API
Brand: Careerjet Job Search API
Availability: InStock

✓ 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.

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.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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)

GET STARTED

Start building with Careerjet Job Search API

Explore with Jentic

View OpenAPI Document

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?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Careerjet API keys are stored encrypted in Jentic's vault. Agents receive scoped execution rights only — the key is injected as the basic-auth username at request time and never enters the agent's prompt or chat logs.

Intent-based discovery

Agents search Jentic by intent (e.g., 'search for jobs by keyword and location') and Jentic returns the GET /query operation with its full input schema, so the agent provides the right parameters without reading the partner docs.

Time to first call

Direct Careerjet integration: 2-4 hours for auth wiring, parameter validation, and pagination across the single endpoint. Through Jentic: under 15 minutes — search, load, execute.

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.