Technical walkthroughs and architectural guides for common hiring data challenges. Learn how to handle location normalization, salary extraction, and more.
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
A detailed guide to keeping a local job index in sync with CleanJobData — cursor pagination mechanics, created_max_age vs published_after, and detecting closed listings.
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 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.
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