Search Jobs

Full-text search over the public OpenTrain job marketplace. This endpoint is tokenless — no Authorization header needed — and CORS-enabled (Access-Control-Allow-Origin: *), so it works from browsers, scripts, and agents without any onboarding. Responses are cached at the edge (Cache-Control: public, s-maxage=300, stale-while-revalidate=3600).

For filter values to offer in a UI, fetch GET /jobs/facets first. To track marketplace changes incrementally, poll GET /jobs/changes.

Requirements: none — no token, no scope, no feature flag. Rate limited to 120 requests/minute per IP.

Request

qstringquery

Free-text search across job titles and descriptions.

categorystringquery

Filter by job category (use values from facets).

languagestringquery

Filter by required language.

countrystringquery

Filter by allowed country.

payTypestringquery

PAY_PER_HOUR, FIXED_PRICE, or PAY_PER_LABEL. Any other value returns 400.

limitnumberquery

Default: 50

Page size, max 100.

cursorstringquery

Opaque pagination cursor from a previous response’s nextCursor.

OPTIONS on this path returns 204 with the CORS headers (preflight support).

Response

jobsobject[]

Matching public jobs, each a full job object.

job object

idstring

Job ID — usable with GET /jobs/{id}.

slugstring

URL slug.

titlestring

Job title.

companyNamestring

Hiring company’s display name.

descriptionTextstring

Plain-text description.

descriptionHtmlstring

HTML description.

seoTitlestring | null

Standardized title when available.

summarystring | null

Short standardized summary when available.

statusstring | null

Marketplace status (open jobs only appear here).

datePostedstring

ISO timestamp of the original posting date.

validThroughstring

ISO timestamp — rolling listing expiry.

updatedAtstring

ISO timestamp of the last update.

employmentTypesstring[]

schema.org employmentType values (e.g. CONTRACTOR).

countriesstring[]

ISO country codes; empty array means worldwide.

languagesstring[]

Required languages.

categorystring | null

Job category.

dataTypestring | null

Data type being labeled (e.g. Text, Audio).

labelTypesstring[]

Label/annotation types.

labelingSoftwarestring | null

Required labeling tool, when specified.

experienceLevelstring | null

Human-readable level (e.g. Expert), null when unspecified.

skillsstring[]

Employer-tagged skills.

payobject

Pay details. paymentType is PAY_PER_HOUR, FIXED_PRICE, PAY_PER_LABEL, or null; currency is always USD. Rate fields (hourlyRate, hourlyMin, hourlyMax, fixedPrice, perLabelRate) are numbers or null depending on the payment type.

urlstring

Canonical public listing URL.

applyUrlstring

Tracked apply redirect. Always use this URL to send applicants — never construct apply links yourself.

nextCursorstring | null

Pass back as cursor for the next page; null when there are no more results.

generatedAtstring

ISO timestamp when the response was generated (responses are edge-cached up to 5 minutes).

Errors

Status	code	Meaning
400	BAD_REQUEST	Invalid payType or malformed parameters
429	RATE_LIMITED	Over 120 requests/minute from one IP

Request examples

curlCLIMCP: opentrain_search_jobs

curl

curl -sS "https://app.opentrain.ai/api/public/v1/jobs?q=audio%20annotation&payType=PAY_PER_HOUR&limit=10"

CLI

opentrain jobs search --q "audio annotation" --pay-type PAY_PER_HOUR --limit 10 --json

MCP: opentrain_search_jobs

{
  "q": "audio annotation",
  "payType": "PAY_PER_HOUR",
  "limit": 10
}

Response examples

200

{
  "jobs": [
    {
      "id": "<JOB_ID>",
      "slug": "spanish-audio-annotation",
      "title": "Spanish Audio Annotation",
      "companyName": "Acme AI",
      "descriptionText": "Transcribe and annotate Spanish call-center audio...",
      "descriptionHtml": "<p>Transcribe and annotate Spanish call-center audio...</p>",
      "seoTitle": null,
      "summary": null,
      "status": "OPEN",
      "datePosted": "2026-06-01T12:00:00.000Z",
      "validThrough": "2026-07-27T12:00:00.000Z",
      "updatedAt": "2026-06-10T09:30:00.000Z",
      "employmentTypes": ["CONTRACTOR"],
      "countries": [],
      "languages": ["Spanish"],
      "category": "Audio Annotation",
      "dataType": "Audio",
      "labelTypes": ["Transcription"],
      "labelingSoftware": null,
      "experienceLevel": "Intermediate",
      "skills": ["Transcription"],
      "pay": {
        "paymentType": "PAY_PER_HOUR",
        "currency": "USD",
        "hourlyRate": 12,
        "hourlyMin": null,
        "hourlyMax": null,
        "fixedPrice": null,
        "perLabelRate": null
      },
      "url": "https://app.opentrain.ai/jobs/spanish-audio-annotation-<JOB_ID>",
      "applyUrl": "https://app.opentrain.ai/api/out?job=<JOB_ID>&src=www_seo"
    }
  ],
  "nextCursor": null,
  "generatedAt": "2026-06-12T08:00:00.000Z"
}