hired.search.sources.jobspy#

JobSpy source adapter.

Wraps the python-jobspy package to search across multiple job boards (LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google) concurrently.

Functions

get_jobspy_source()

Get the default JobSpy source instance.

Classes

JobSpySource([sites, proxies])

JobSpy source implementation.
class hired.search.sources.jobspy.JobSpySource(sites=None, proxies=None)[source]#

Bases: JobSearchSource

JobSpy source implementation.

Uses python-jobspy to scrape jobs from multiple sources simultaneously. Does not require API keys, but may be subject to rate limiting.

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

Parameters:

criteria (SearchCriteria) – Search criteria

Return type:

List[JobResult]

Returns:

List of JobResult objects

hired.search.sources.jobspy.get_jobspy_source()[source]#

Get the default JobSpy source instance.

Return type:

JobSpySource