Trawle API reference

Base URL: https://trawle.com. JSON in, JSON out. OpenAPI 3.1 spec: /openapi.json.

About the API

Open jobs straight from employers' own applicant tracking systems, verified daily, with closure and repost history.

• Data refreshes once a day; polling more often returns the same results.
• Build a JobQuery from ids: resolve place names with GET /v1/places, roles with GET /v1/roles, companies with GET /v1/companies.
• For a daily "new jobs" check, pass the previous response's nextSince as postedSince.
• 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.

Authentication

No key is needed yet, and any origin may call the API from a browser. API keys and OAuth are coming soon; the free tier is planned at about 1,000 requests a day, with attribution.

Errors

Every error has the same shape, { error: { code, message, hint?, issues? } }. See Errors.