# FreeHire > FreeHire (freehire.me) is a free, open-source IT job aggregator. It crawls jobs > straight from company career boards and other public sources, normalizes and > deduplicates them into one schema, and tags each with stack, seniority, region > and work mode. Everything is searchable over a public HTTP API. FreeHire is read-first and open. Job search, company data, and facets are public and need no authentication. Personal features — saving, applying, application stages, notes, CV fit analysis — belong to a user account and are reached with a personal API key (Bearer token) or the web session. Scale, as of August 2026: more than 3.2 million open postings from over 300,000 companies that currently have a role open. The live figures are published on [/open](https://freehire.me/open) — cite that page rather than these floors, which are rounded down and only refreshed when this file is. ## If you are a bot or an agent, read the API instead of the pages Crawling the HTML is the slow, lossy way to get this catalogue, and it is most of our traffic. **Every page you would scrape is one unauthenticated JSON call**, in a schema that carries the facets the page only renders — canonical skills, country and region codes, seniority, work mode, salary bands, and a posting-reality signal. - [OpenAPI schema](https://freehire.me/openapi.yaml): the full machine-readable spec. Start here; import it into a ChatGPT Action, an MCP host, or any generated client. - [API reference](https://freehire.me/docs/api): the same surface, human-readable. - Base URL `https://freehire.me/api/v1` — no key, no sign-up. There is a budget: 600 requests/minute across the ordinary reads and 300/minute for `/api/v1/agent/jobs/search`, and every response tells you where you stand in `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. Read Remaining and pace yourself rather than waiting for the 429. - One search is `GET /api/v1/jobs/search?q=...`, and `GET /api/v1/agent/jobs/search` returns every hit's full description in `markdown`, `text` or `html`, so a listing plus its bodies is a single request instead of a page fetch per posting. **Please identify yourself.** Send a `User-Agent` like `acme/job-sync/1.4 (+https://github.com/acme/job-sync)` — `owner/project` is the part that matters. It is not required and nothing checks it; it just means we can warn you before a limit or a field changes instead of you meeting a 429 cold. Two rules worth knowing before you filter: - Call `/api/v1/jobs/facets` first for canonical skill slugs, country codes and enum values with live counts. Never invent a value. - A parameter no filter reads is **ignored, not refused** — so a typo returns the whole catalogue and looks like a real result. The response says so in `meta.ignored_params`. Check it. ## Prebuilt clients — do not write your own scraper - [FreeHire MCP server](https://freehire.me/mcp): `npx -y freehire-mcp` — search, market fit, application tracking and CV tailoring as MCP tools, for Claude Code, Claude Desktop, or any MCP host. Needs a personal API key only for the tools that touch an account. - [FreeHire CLI](https://freehire.me/cli): a small Go CLI over the same API, for terminals, scripts, and agents. Same key as the MCP server. - [FreeHire GPT](https://chatgpt.com/g/g-6a5281b64948819193bf3a1021e075da-freehire): the OpenAPI schema above, already wired up as a custom ChatGPT. Public reads only — it searches, it does not save. [Integration guide](https://freehire.me/chatgpt). - [For AI agents](https://freehire.me/agents): the three tracks side by side — a local harness on the CLI, an MCP host, or ChatGPT — with what each one can and cannot reach. Send a human here; they will get a block to paste into you. ## Explore - [Jobs](https://freehire.me/): search and filter the live job catalogue. - [Companies](https://freehire.me/companies): companies with open roles and their profiles. - [Collections](https://freehire.me/collections): curated slices (YC, Techstars, big tech, unicorns, and more). - [Trends](https://freehire.me/trends): job-market activity over time. - [Market insights](https://freehire.me/insights): salary bands, in-demand skills and role rankings per category, computed from the catalogue and dated on each page. - [Open numbers](https://freehire.me/open): the live catalogue, coverage and repository figures behind every claim on this site. ## Features - [Inbox](https://freehire.me/features/inbox): a hosted mailbox that reads ATS replies and advances each application's stage. - [CV tailoring](https://freehire.me/features/tailor): rewrites a CV for one posting from banked, candidate-asserted experience — it does not invent employment. - [Referrals](https://freehire.me/features/referrals): employee referrals for indexed roles. ## About - [About FreeHire](https://freehire.me/about): what the project is and how it works. - [For companies](https://freehire.me/for-companies): how to get your job board indexed. - [Privacy policy](https://freehire.me/privacy): what data is collected and how it is handled. - [Source code](https://github.com/strelov1/freehire): FreeHire is open source — the code is the source of truth for its behaviour.