Search for jobs using the CleanJobData API

Results are paginated with opaque cursors: pass the response's pagination.next_page (or prev_page) token back as cursor to move through pages.

Args: title: Full-text search on job title / keywords sort_by: Sort order: "published" (default) or "relevance" (requires title) city_id: City IDs to filter by (use suggest_locations to find IDs) state_id: State IDs to filter by (use suggest_locations to find IDs) country_id: Country IDs to filter by (use suggest_locations to find IDs) location: ISO 3166-1 alpha-2 country codes (e.g. ["US", "DE"]); used when no city/state/country IDs are provided remote: True to return remote-only jobs remote_type: One of fully_remote, remote_country, remote_region, hybrid company_name: Substring match on company name employer_id: Company IDs to filter by (max 100) salary_min: Minimum salary for the salary range filter salary_max: Maximum salary for the salary range filter require_salary: True to only return jobs with a verified salary experience_level: Experience levels: EN (entry), MI (mid), SE (senior), EX (executive) employment_type: Employment types: FULL_TIME, PART_TIME, CONTRACT, INTERN, TEMPORARY, FREELANCE, APPRENTICESHIP, VOLUNTEER, PER_DIEM, OTHER published_after: Only jobs published at or after this ISO 8601 instant max_age: Rolling window on published date, integer with optional unit h/d/w (e.g. "7d") include_expired: True to also include closed/expired listings include_description: True to include the full HTML job description (excluded from list results by default) limit: Results per request (1-100) cursor: Opaque pagination token from a previous response count: True to include the total job count in pagination (costs an extra query)

Get detailed information about a specific job, including its full description

Args: job_id: The unique numeric identifier of the job

Search for companies using the CleanJobData API

query, website_url, and employer_id are mutually exclusive lookup modes, checked in priority order: employer_id, then website_url, then query.

Args: query: Company name to search for (fuzzy match, ranked by relevance) website_url: Match by registrable domain; accepts a bare domain or full URL employer_id: Look up one or more companies directly by ID (max 100) active: Only return companies with active jobs (default true) limit: Results per request (max 100 when searching) offset: Skip this many rows

Get detailed information about a specific company, including enrichment data

Args: company_id: The unique identifier of the company (employer_id)

Look up city/state/country IDs by name for use in search_jobs filters

Args: query: The search query (e.g. a city, state, or country name) kinds: Location types to include: city, state, country (default all) limit: Maximum results to return (1-30)