Adzuna SDKs & Libraries: Search & Trends Integration (2026)

SDKs overview

Adzuna provides an API that allows developers to integrate job search, salary benchmarking, and job market trend data into their applications. To facilitate this integration, Adzuna offers official SDKs and supports community-contributed libraries across several popular programming languages. These SDKs abstract away the complexities of direct HTTP requests, authentication, and response parsing, allowing developers to focus on application logic rather than API mechanics. The primary goal of these libraries is to accelerate development cycles for applications that require access to Adzuna's extensive job data.

The Adzuna API itself follows a RESTful architecture, typically returning data in JSON format, which is a common data interchange format for web APIs W3C JSON standard. SDKs handle the serialization and deserialization of this data, presenting it as native objects within the chosen programming language. This approach is standard practice for many API providers, including platforms like Stripe and Twilio, which also offer comprehensive SDKs to simplify integration Stripe API documentation Twilio SDKs overview.

Adzuna's developer portal provides detailed documentation for getting started with their API, including information on obtaining API keys, understanding rate limits (5,000 requests/month on the free tier), and exploring the various endpoints available for job search, salary, and trends data Adzuna developer portal. While Adzuna focuses on the job market, the principles of using SDKs apply broadly across various API categories, from payments to communications.

Official SDKs by language

Adzuna maintains official SDKs to ensure robust and up-to-date integration with their API. These SDKs are designed to provide a consistent and reliable experience for developers. The following table outlines the key official SDKs available, their respective packages, installation commands, and general maturity level, based on information provided in the Adzuna developer documentation Adzuna API documentation.

Each SDK is tailored to the idiomatic practices of its respective language, offering methods that map directly to API endpoints and parameters. This allows developers to interact with the Adzuna API using familiar programming constructs, enhancing productivity and reducing the learning curve. For instance, a Python developer can expect to use Python objects and methods to query job listings, rather than constructing raw HTTP requests with query parameters manually.

Installation

Installing Adzuna's official SDKs typically involves using the standard package manager for the chosen programming language. The process is designed to be straightforward, allowing developers to quickly integrate the libraries into their projects. Below are detailed installation steps for the most commonly used languages:

Python Installation

To install the Python SDK, use pip, the Python package installer. It's recommended to do this within a virtual environment to manage dependencies effectively MDN Web Docs on virtual environments.

pip install adzuna-api-client

Ruby Installation

For Ruby projects, the SDK is available as a gem. Use the gem command to install it:

gem install adzuna-api-ruby

PHP Installation

PHP projects typically use Composer for dependency management. Add the Adzuna client to your composer.json file and then run composer install:

composer require adzuna/api-client

Node.js Installation

For Node.js applications, use npm (Node Package Manager) or yarn to install the package:

npm install adzuna-api-node
// or
yarn add adzuna-api-node

Java Installation

Java projects often use Maven or Gradle. For Maven, add the dependency to your pom.xml:

<dependency>
    <groupId>com.adzuna</groupId>
    <artifactId>adzuna-api-java</artifactId&n>
    <version>1.0.0</version> <!-- Replace with the latest version -->
</dependency>

For Gradle, add to your build.gradle:

implementation 'com.adzuna:adzuna-api-java:1.0.0' // Replace with the latest version

C# Installation

For .NET projects, use the NuGet Package Manager via the .NET CLI:

dotnet add package Adzuna.API.Client

After installation, developers will need their Adzuna API key and application ID, which can be obtained from the Adzuna developer portal Adzuna API key management. These credentials are essential for authenticating requests to the Adzuna API.

Quickstart example

This quickstart example demonstrates how to use the Python SDK to perform a basic job search. The process involves initializing the client with your application ID and API key, and then calling the appropriate method to fetch job listings. This example assumes you have already installed the adzuna-api-client package as described in the installation section.

Python Job Search Example

The following Python code snippet illustrates how to search for jobs using the Adzuna API client. Replace YOUR_APP_ID and YOUR_API_KEY with your actual credentials from the Adzuna developer portal Adzuna developer credentials.

from adzuna_api_client import AdzunaClient

# Replace with your actual Adzuna App ID and API Key
APP_ID = "YOUR_APP_ID"
API_KEY = "YOUR_API_KEY"

# Initialize the Adzuna client
client = AdzunaClient(app_id=APP_ID, api_key=API_KEY)

try:
    # Perform a job search
    # Parameters: what (keywords), where (location), max_days_old, results_per_page, page
    response = client.search_jobs(
        what="software developer",
        where="london",
        max_days_old=7,
        results_per_page=10,
        page=1
    )

    # Check if the request was successful
    if response and 'results' in response:
        print(f"Found {response.get('count', 0)} jobs.")
        for job in response['results']:
            print(f"Job Title: {job.get('title')}")
            print(f"Company: {job.get('company', {}).get('display_name')}")
            print(f"Location: {job.get('location', {}).get('display_name')}")
            print(f"URL: {job.get('redirect_url')}")
            print("-----------------------------------")
    else:
        print("No jobs found or an error occurred.")
        if response and 'error' in response:
            print(f"Error details: {response['error']}")

except Exception as e:
    print(f"An unexpected error occurred: {e}")

This example demonstrates querying for "software developer" jobs in "london" that were posted within the last 7 days, retrieving 10 results per page. The output includes the job title, company, location, and a direct URL to the job posting. Developers can adjust the parameters to refine their search queries according to their specific application requirements, such as specifying salary ranges, employment types, or industry sectors Adzuna Job Search API reference.

Community libraries

While Adzuna provides official SDKs, the developer community often contributes additional libraries and wrappers. These community-driven projects can offer alternative implementations, support for less common languages, or specialized functionalities not present in the official SDKs. Community libraries are often found on platforms like GitHub and can be identified by searching for "Adzuna API" or "Adzuna client" in conjunction with specific programming languages.

The maturity and maintenance levels of community libraries can vary significantly. Some might be actively developed and well-supported, while others may be experimental or no longer maintained. Developers considering using a community library should evaluate its documentation, recent commit history, issue tracker, and community engagement to assess its suitability for their project. It is also advisable to review the source code for security and reliability before integrating it into production systems.

For instance, a community library might provide a more opinionated ORM-like interface for interacting with job data, or offer built-in caching mechanisms. While Adzuna's official documentation primarily focuses on its own SDKs, the open-source nature of many programming ecosystems means that community contributions are a natural extension. Developers looking for specific features or alternative approaches might find value in exploring these community-maintained resources, though they should always prioritize security and stability, especially for critical applications. The official Adzuna developer portal is the primary resource for supported integration methods Adzuna developer resources.