Careerjet API

Overview

The Careerjet API offers a RESTful interface for accessing job listings aggregated from various sources globally. Established in 2000, Careerjet operates as a job search engine that collects and indexes job postings directly from company websites, recruitment agencies, and specialized job boards. The API exposes this extensive database, allowing developers and technical buyers to integrate job search functionality into their own platforms or build specialized applications that require job market data.

The primary use cases for the Careerjet API include powering custom job boards, enabling job search features within broader applications (such as HR software or career development platforms), and supporting academic or commercial research into job market trends. The API's capabilities allow for filtering job listings by keywords, location, company, and other criteria, providing developers with control over the search parameters and the presentation of results. Its global reach is a distinguishing factor, offering access to jobs in over 90 countries and 28 languages, which can be beneficial for applications targeting an international audience.

For non-commercial projects, Careerjet provides free API access, making it accessible for educational initiatives, personal projects, or proof-of-concept development. Commercial use requires a paid subscription, with pricing structured around query volume. The API's design emphasizes ease of integration, offering clear documentation and example code in several programming languages, which can streamline the development process for teams looking to quickly deploy job search capabilities without building an indexing system from scratch.

The API's data aggregation approach means it serves as a centralized point for accessing a wide array of job opportunities that might otherwise require integration with multiple individual sources. This can reduce the complexity for developers seeking comprehensive job data. For instance, platforms like Indeed and Adzuna also offer job APIs, and each aggregates job postings differently, potentially leading to variations in coverage and data freshness. The Careerjet API aims to provide a broad dataset for developers to work with, supporting various applications from simple job widgets to complex analytical tools.

Key features

• Global Job Search: Access to millions of job listings across more than 90 countries and 28 languages, facilitating international job search applications.
• Keyword and Location Filtering: Supports detailed search queries based on job titles, keywords, company names, and specific geographic locations.
• Pagination and Sorting: Provides parameters for managing result sets, including pagination for large queries and options for sorting results by relevance or date.
• XML and JSON Output: Offers results in both XML and JSON formats, allowing developers to choose the data representation that best fits their application's architecture.
• Multilingual Support: Enables job searches and result presentation in multiple languages, catering to diverse user bases.
• API Key Authentication: Secures API access through an API key, managing usage and distinguishing between commercial and non-commercial accounts.
• Customizable Search Parameters: Allows for fine-tuning search queries with parameters such as job type (full-time, part-time), salary range, and date posted.

Pricing

Careerjet offers a free tier for non-commercial use, with paid plans based on query volume for commercial applications. Pricing details are available on their API pricing page.

Common integrations

• Custom Job Boards: Embedding job search functionality directly into proprietary job board platforms.
• Career Portals: Integrating job listings into university career services websites or professional association portals.
• HR Software: Enhancing applicant tracking systems or talent management platforms with external job market data.
• Data Analytics Platforms: Utilizing job data for market research, trend analysis, or economic forecasting.
• Mobile Applications: Developing native mobile apps that allow users to search for jobs on the go.
• Website Widgets: Creating embeddable job search widgets for blogs or corporate websites.

Alternatives

• Indeed API: Provides access to job listings from Indeed's extensive database, often used for broad job search integrations.
• Adzuna API: Offers a job search API with additional features like salary data and trend analysis.
• ZipRecruiter API: Focuses on connecting employers with job seekers, offering an API for job posting and candidate search.

Getting started

To begin using the Careerjet API, developers typically obtain an API key from the Careerjet partners page. The API supports standard HTTP GET requests, returning data in either XML or JSON format. The following Python example demonstrates a basic job search query for 'software developer' jobs in 'London'.

import requests
import json

API_KEY = "YOUR_API_KEY" # Replace with your actual API key
COUNTRY_CODE = "uk" # For United Kingdom
LOCALE = "en_GB" # English (Great Britain)
KEYWORDS = "software developer"
LOCATION = "london"
PAGE_NUMBER = 1
RESULTS_PER_PAGE = 20

base_url = "http://public.api.careerjet.net/search"

params = {
    "keywords": KEYWORDS,
    "location": LOCATION,
    "sort": "relevance",
    "start_num": (PAGE_NUMBER - 1) * RESULTS_PER_PAGE + 1,
    "pagesize": RESULTS_PER_PAGE,
    "user_ip": "127.0.0.1", # Required, use actual user IP in production
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36", # Required, use actual user agent
    "affid": API_KEY,
    "locale": LOCALE,
    "user_country_code": COUNTRY_CODE,
    "format": "json"
}

try:
    response = requests.get(base_url, params=params)
    response.raise_for_status() # Raises an HTTPError for bad responses (4xx or 5xx)
    data = response.json()

    if data and data.get("jobs"): # Check if 'jobs' key exists and is not empty
        print(f"Found {data['hits']} jobs for '{KEYWORDS}' in '{LOCATION}':\n")
        for job in data["jobs"]:
            print(f"  Title: {job['title']}")
            print(f"  Company: {job['company']}")
            print(f"  Location: {job['location']}")
            print(f"  URL: {job['url']}\n")
    else:
        print(f"No jobs found for '{KEYWORDS}' in '{LOCATION}'.")

except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred: {http_err}")
except Exception as err:
    print(f"An error occurred: {err}")

This Python script uses the requests library to send a GET request to the Careerjet API. It constructs the URL with necessary parameters, including the API key, keywords, location, and desired output format. The response is then parsed as JSON, and details of the retrieved job listings are printed to the console. Developers should refer to the Careerjet API reference for a comprehensive list of available parameters and response structures.