Technical walkthroughs and architectural guides for common hiring data challenges. Learn how to handle location normalization, salary extraction, and more.
Make your first request and add job search to a product.
Job Search API Quickstart: Your First Query in 5 Minutes
Get a free API key and run your first job search request with curl, JavaScript or Python, then add filters, field selection and pagination.
How to Add Job Search to an Existing App
Integrate CleanJobData into a product that isn't a job board — a career-content site, HR tool, or community app — without building a new frontend from scratch.
Choosing the Right Filters for Your Use Case
A practical decision guide for combining title, location, remote, seniority, and salary filters depending on what you're building.
Syncing data, working with geo IDs and connecting the API to your tools.
CleanJobData MCP Server: Local Setup Guide
How to install and configure the community-built CleanJobData MCP server locally, and wire it into Claude Desktop, Claude Code, or Cursor.
Syncing Job Data: Pagination, Freshness Filters, and Closed Listings
How to keep your own database in sync with CleanJobData: first load, new listings with created_max_age, closed listings with /jobs/expired, plus cursor pagination, rate limits and quota.
How to Use Geo Suggest with the Jobs API
A detailed guide to building location autocomplete with the Geo Suggest endpoint and feeding resolved IDs into the Jobs API for precise filtering.
How locations, salaries and experience levels are normalized, and how to use them.
Experience Level Mapping for Job Listings
How CleanJobData maps job titles into seniority tokens for reliable filtering — and what to do about the listings that don't map to anything.
Interpreting the Job Location Object
How to read the locations array on a Job object — resolution granularity, multi-location postings, is_primary, and remote flags — once you already have jobs back from the API.
Salary Data Extraction from Job Listings
How to use CleanJobData salary fields to display, filter, and analyze compensation data.
Looking for regional feeds? Explore Data Feeds · Engineering Articles
