# Trawle for developers

Search open jobs read straight from employers' own applicant tracking systems, checked every day, with closure and repost history.

Trawle is a job index built from employers' own careers pages: Greenhouse, Lever, Ashby, Workday and more than fifteen other applicant tracking systems. Every board is scanned once a day. Jobs that disappear are marked closed, reposts are linked to the original, and every job knows how long it has really been open.

You can search it with a JSON API, or let an AI agent search it through the MCP server.

## Where to start

- [Quickstart](https://developers.trawle.com/quickstart): your first search, building a query from lookups, reading results.
- [Search jobs API](https://developers.trawle.com/api): the reference, generated from the OpenAPI spec.
- [MCP for agents](https://developers.trawle.com/mcp): tools and a daily job search prompt for AI assistants (preview).
- [Guides](https://developers.trawle.com/guides/daily-new-jobs): daily new-jobs checks, building a `JobQuery`, pagination, errors, freshness, attribution.

## Good to know

- Data refreshes once a day. Polling more often returns the same results.
- No API key is needed yet. API keys are coming soon; the free tier is planned at about 1,000 requests a day, with attribution.
- Results link to the employer's posting (`applyUrl`) and to Trawle (`url`). Show "Data by Trawle" with a link when you display them.
- Full job descriptions are not served. Link to `applyUrl` instead.

## Machine-readable

- [/llms.txt](https://developers.trawle.com/llms.txt) and [/llms-full.txt](https://developers.trawle.com/llms-full.txt)
- [/openapi.json](https://developers.trawle.com/openapi.json): the public OpenAPI 3.1 spec
- Every page is also available as Markdown: add `.md` to its URL.