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

Feed field reference

Every field in the OpenTrain XML, JSON, CSV and RSS job files, with the unique key, translated copies, closed jobs and refresh rules.

OpenTrain publishes every open job in four bulk files. None needs a key or a sign-up. This page lists the fields in each one. For which file to pick, see Job feeds and API.

FileLinkJobs
XMLhttps://app.opentrain.ai/feeds/jobsEvery open job, plus a translated copy for some jobs
JSONhttps://app.opentrain.ai/feeds/jobs.jsonEvery open job, once each
CSVhttps://app.opentrain.ai/feeds/jobs.csvEvery open job, once each, same columns as the JSON file
RSS 2.0 or Atomhttps://app.opentrain.ai/feeds/jobs/rssThe newest 100 jobs
  • Refresh. The files update by themselves through the day. Import a file every 10 minutes at most; more often brings nothing new.
  • Repeat requests. The XML, JSON and CSV files answer 304 Not Modified when you send the ETag you got back as If-None-Match, or the Last-Modified time as If-Modified-Since.
  • Closed jobs. A job that closes leaves the file. Delete jobs that are no longer in the file. The changes feed also lists each closed job.
  • Personal data. None. OpenTrain AI is the company on every job.
  • Apply link. Send applicants to the apply link (applyurl or applyUrl) and keep it as it is.

The XML file uses the common job-board layout: one <source> with <publisher>, <publisherurl> and <lastBuildDate>, then one <job> for each job.

FieldWhat it holds
idThe job’s unique key. Use it to match a job across imports.
referencenumberThe same id with an opentrain- prefix, for tools that ask for a reference number.
titleJob title.
companyAlways OpenTrain AI.
dateWhen the job was posted.
expirationdate, closingdateRolling dates that move forward with every build. They are not the date a job closes. Close a job when it leaves the file.
urlThe job page on www.opentrain.ai.
applyurlThe apply link.
countryCountries the job is open to, comma-separated, as names.
remotetrue for remote work.
jobtypeFor example contract, parttime.
salaryPay as text, for example $15 per hour. Left out when the job lists no pay.
categoryCategory name, for example Audio & Speech.
languagesLanguage codes the work needs, comma-separated, for example en, es.
descriptionThe job description as HTML, in a CDATA block.

Translated copies. Some jobs also appear in a second language. A translated copy has the same id with a hyphen and a language code, for example …x163332859756544000-es, and its url points to the translated job page. To list each job once, skip ids that contain a hyphen.

  1. Choose job as the record element and job listings as the post type.
  2. Set the unique identifier to {id[1]}.
  3. Add the filter id does not contain -.
  4. Turn on removing posts that are no longer in the file, for posts this import made.

Automatic imports from the link need WP All Import Pro. With the free plugin, save the file and upload it by hand.

The JSON file has publisher, publisherUrl, generatedAt, count and a jobs array. The CSV file has one row per job with the same fields as columns; list fields are joined with commas.

FieldWhat it holds
idThe job’s unique key.
titleJob title.
companyAlways OpenTrain AI.
urlThe job page on www.opentrain.ai.
applyUrlThe apply link.
categoryCategory slug, for example audio-speech.
categoryLabelCategory name, for example Audio & Speech.
payPay as text, for example $15 per hour.
payTypePAY_PER_HOUR, FIXED_PRICE or PAY_PER_LABEL.
jobTypeFor example contract, parttime.
remotetrue for remote work.
locationCountries the job is open to, as names.
countriesTwo-letter country codes.
languagesLanguage codes the work needs.
datePostedWhen the job was posted (ISO 8601, UTC).
closingDateA rolling date, not the date the job closes.
updatedAtWhen the job last changed.
descriptionThe job description as plain text.
descriptionHtmlThe same description as HTML (JSON file only).

https://app.opentrain.ai/feeds/jobs/rss lists the newest 100 jobs. Each item has title, link (the job page), guid, pubDate and description (HTML), plus category when the job has one.

  • Add ?format=atom for the same jobs in Atom format.
  • Add ?language= and a language code for jobs in one language, for example ?language=es.
  • Add ?category= and a category slug for one category, for example ?category=audio-speech. The facets list has every slug.

In Google Sheets, =IMPORTFEED("https://app.opentrain.ai/feeds/jobs/rss") in cell A1 loads the newest 100 jobs, one row each.

Each job page link and apply link carries ch= and sub= values that say which file it came from, for example ch=feed_csv&sub=csv. Keep them, so people who come from your site are counted correctly. The JSON API lets you set your own sub= value.