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

Public jobs API

Read-only JSON API for open OpenTrain jobs: list, search, read one job, the changes feed and facets. No key, CORS open, 600 requests a minute and no daily limit.

The public jobs API answers anonymous GET requests with JSON. It needs no account, key or token, allows requests from any website (CORS *) and has no daily limit. It is separate from the authenticated Public API that employers and agents use to post and manage jobs.

For every open job in one request, use a bulk file instead of paging through the API.

Method and pathWhat it returns
GET /jobsThe newest open jobs, newest first.
GET /jobs/search?q=Open jobs ranked by relevance to q.
GET /jobs/{id}One open job.
GET /jobs/changes?since=Jobs published, updated or closed since a time.
GET /jobs/facetsCategory and domain slugs with job counts.
GET /jobs/openapi.jsonThe OpenAPI file.
Terminal window
curl "https://app.opentrain.ai/api/public/v1/jobs?view=compact&order=newest&limit=25"
curl "https://app.opentrain.ai/api/public/v1/jobs/search?q=python&view=compact&limit=25"
ParameterUse
qSearch only. Free text, 1 to 200 characters, for example pharmacy AI training.
viewcompact: jobs without descriptions or HTML. Without view, GET /jobs returns the full job with HTML.
orderGET /jobs only. newest.
categoryA category slug from GET /jobs/facets.
domainA subject-matter domain slug from GET /jobs/facets.
languageA language the work needs, such as en, es or fil.
countryTwo-letter country of the person, such as US. Jobs with no country restriction are included.
payTypePAY_PER_HOUR, FIXED_PRICE or PAY_PER_LABEL.
limitJobs per page with view=compact, 1 to 25. Default 10. A larger number returns 25.
cursorThe nextCursor from the previous page of the same request.

The answer has generatedAt, jobs and nextCursor. nextCursor is null on the last page. Search pages through the top 100 results.

Terminal window
curl "https://app.opentrain.ai/api/public/v1/jobs/{id}?view=agent"

The id is the id from a list or search result, or the part after the last -- of a job page URL. view=agent returns the job with a plain-text description (descriptionText) and no HTML. A closed, private or unknown job returns 404; a closed job’s body is {"id": "…", "status": "closed"}.

Each job’s url is its job page, where a person reads the job and applies. Link it exactly as returned. applyMode is opentrain when the person applies on OpenTrain, or signup_first when the person signs up on OpenTrain first and then finishes on another site (external in the agent view).

Terminal window
curl "https://app.opentrain.ai/api/public/v1/jobs/changes?since=2026-11-01T00:00:00Z"

Each entry in changes has jobId, eventType (PUBLISHED, UPDATED or CLOSED) and occurredAt. The answer stops at the time in until. To stay in sync, pass until back as the next since. If until is before now, ask again at once from that time.

GET /jobs/facets returns totalJobs and the categories and domains with a job count for each value. Use the values as category and domain filters.

In the full view, each job’s url and applyUrl carry ch=public_api and a sub= label. Send ?sub= with your site’s name (letters, digits, ., _ and -, up to 40 characters) and the links carry it, so people who come from your site are counted as yours. Without it, sub is api.

  • 600 requests a minute per IP address, with no daily limit. Searches with q (on GET /jobs/search, GET /jobs and the MCP search tool together) also count against 120 a minute per IP address.
  • Answers are cached at the edge, so repeat reads are fast.
  • Every answer carries X-RateLimit-Limit. Too many requests get 429 with Retry-After in seconds, plus X-RateLimit-Remaining, X-RateLimit-Reset and RateLimit-Policy. Wait that long, then carry on.
  • A bad parameter value, such as an unknown payType, or a missing since on the changes feed gets 400. An unknown job id gets 404.

See Fair use and limits.