Careerjet Job Search API

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.