Skip to content
OpenTrain AIOpenTrain AIOpenTrain AIDocs

Ask OpenTrain

Answers from the documentation, with sources.

What would you like to do with OpenTrain?

AI answers can be mistaken. Check the linked sources. Don’t include private account information.

Open app

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.

Entry pointLimit
XML, JSON, CSV and RSS filesNo speed limit.
Public jobs API600 requests a minute per IP address.
Job search MCP server600 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.

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.

  • Import a file every 10 minutes at most. It does not change faster than that.
  • Send If-None-Match or If-Modified-Since on repeat requests to the XML, JSON and CSV files. An unchanged file answers 304 Not Modified with 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.

Write to support@opentrain.ai.