DEVELOPER DOCUMENTATION
Fair use and limits
Speed limits for the OpenTrain job feeds, API and MCP server, what a 429 means, and the five requests for sites that repost our jobs.
Anyone may scrape and repost OpenTrain jobs, including commercial sites. There is no sign-up, no key and no daily limit. The speed limits below only stop one address from sending too many requests at once.
Speed limits
Section titled “Speed limits”| Entry point | Limit |
|---|---|
| XML, JSON, CSV and RSS files | No speed limit. |
| Public jobs API | 600 requests a minute per IP address. |
| Job search MCP server | 600 requests a minute per IP address. |
Searches with q (API and MCP together) | Also 120 a minute per IP address. |
There is no daily limit anywhere. At 600 a minute you can read every open job one by one in a few minutes, but one request for the XML, JSON or CSV file gets every job at once.
When you go too fast
Section titled “When you go too fast”Too many requests get HTTP 429 with a Retry-After header in seconds. Wait that long, then carry on. The API’s 429 also carries X-RateLimit-Remaining, X-RateLimit-Reset and RateLimit-Policy, and every API answer carries X-RateLimit-Limit.
Be kind to the files
Section titled “Be kind to the files”- Import a file every 10 minutes at most. It does not change faster than that.
- Send
If-None-MatchorIf-Modified-Sinceon repeat requests to the XML, JSON and CSV files. An unchanged file answers304 Not Modifiedwith no body. - Use the changes feed to find closed jobs between full imports.
- Optional: put your site name and an email in your
User-Agent, so we can tell you about feed changes.
Five requests for sites that repost our jobs
Section titled “Five requests for sites that repost our jobs”Commercial sites are welcome. To keep reposted jobs useful, please:
- Keep our apply link.
- Keep the title and pay accurate.
- Remove a job when it closes.
- Say “via OpenTrain” next to each job, or once on the page.
- Don’t present yourself as the employer or use our logo to suggest we endorse you.
These cover job listing content only. Section 10.6 of the Terms of Service has the full permission; these requests are requests, not conditions of it. The feeds may change; the change log lists each change.
Need help?
Section titled “Need help?”Write to support@opentrain.ai.