hired.search.sources.adzuna#

Adzuna source adapter.

Accesses the Adzuna Jobs API (https://developer.adzuna.com/). Requires a free API key (app_id and app_key) from the Adzuna Developer Portal.

Functions

get_adzuna_source()

Get the default Adzuna source instance.

Classes

AdzunaSource([app_id, app_key, country])

Adzuna API source implementation.
class hired.search.sources.adzuna.AdzunaSource(app_id=None, app_key=None, country='us')[source]#

Bases: JobSearchSource

Adzuna API source implementation.

Searches international job postings via the Adzuna Jobs API. Requires a free API key from https://developer.adzuna.com/.

property display_name: str#

Return the display name of this source (e.g., ‘Indeed’, ‘USAJobs’).

get_setup_instructions()[source]#

Return setup instructions for this source.

Should include:

  • Where to get API keys if needed

  • Environment variables or config file settings

  • URLs for documentation

Return type:

str

Returns:

Multi-line string with setup instructions.

is_configured()[source]#

Check if this source is properly configured.

Return type:

bool

Returns:

True if the source is ready to use, False otherwise.

property name: str#

Return the name of this source (e.g., ‘indeed’, ‘usajobs’).

property requires_auth: bool#

Return True if this source requires authentication/API keys.

search(criteria)[source]#

Search for jobs using Adzuna API.

Parameters:

criteria (SearchCriteria) – Search criteria

Return type:

List[JobResult]

Returns:

List of JobResult objects

hired.search.sources.adzuna.get_adzuna_source()[source]#

Get the default Adzuna source instance.

Return type:

AdzunaSource