{
  "openapi": "3.1.0",
  "info": {
    "title": "OpenTrain Jobs",
    "version": "1.0.0",
    "description": "Search and read open jobs on OpenTrain, a marketplace for paid AI training and data work such as labeling, evaluation and subject-matter review.\n\nAnonymous and read-only. Every job carries `url`, its canonical job page, where the person reads the job and applies; link it exactly as returned.\nIn the full view, `url` and `applyUrl` carry `ch=public_api` and `sub`: the label you send as `?sub=` (letters, digits, `.`, `_` and `-`, up to 40 characters), else `api`. Send `?sub=<your site>` so people who come from your site are counted as yours.\n\nLimits: 600 requests a minute per IP address, no daily limit, no key and no sign-up. Searches with a `q` (on /jobs, /jobs/search 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`; a 429 also carries `Retry-After`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` and `RateLimit-Policy`.\n\nEvery open job in one request: JSON at https://app.opentrain.ai/feeds/jobs.json, CSV at https://app.opentrain.ai/feeds/jobs.csv, the XML feed at https://app.opentrain.ai/feeds/jobs and RSS at https://app.opentrain.ai/feeds/jobs/rss. Each answers 304 to a repeat request with `If-None-Match` or `If-Modified-Since`. To keep a copy in sync, poll https://app.opentrain.ai/api/public/v1/jobs/changes?since=<ISO time> and pass its `until` back as the next `since`.\n\nWithout `view`, `/jobs` and `/jobs/{id}` answer the full job (with HTML). Its `applyMode` is `opentrain` (the person applies on OpenTrain) or `signup_first` (the person signs up on OpenTrain first, then finishes on another site). The compact and agent views below name that second case `external`.\n\nPrivacy policy: https://www.opentrain.ai/privacy/",
    "x-privacy-policy-url": "https://www.opentrain.ai/privacy/"
  },
  "servers": [
    {
      "url": "https://app.opentrain.ai/api/public/v1"
    }
  ],
  "security": [],
  "paths": {
    "/jobs/search": {
      "get": {
        "operationId": "searchJobs",
        "summary": "Search open jobs",
        "description": "Ranked search (semantic and full-text) over open jobs. Returns compact jobs, 1 to 25 a page, paging over the top 100 results with `cursor`. Use it when someone looks for paid AI training or data work.",
        "security": [],
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "minLength": 1
            },
            "description": "Free-text search, for example \"pharmacy AI training\"."
          },
          {
            "name": "view",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "compact"
              ],
              "default": "compact"
            },
            "description": "Always `compact`: jobs without descriptions or HTML."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "Category slug from `GET /jobs/facets`."
          },
          {
            "name": "domain",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "Subject-matter domain slug from `GET /jobs/facets`."
          },
          {
            "name": "language",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 35
            },
            "description": "A language the work needs, as a tag such as `en`, `es` or `fil`."
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            },
            "description": "Two-letter ISO country of the person, such as `US`. Jobs with no country restriction are included."
          },
          {
            "name": "payType",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "PAY_PER_HOUR",
                "FIXED_PRICE",
                "PAY_PER_LABEL"
              ]
            },
            "description": "Payment type: hourly, fixed price or per label."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 25,
              "default": 10
            },
            "description": "Jobs per page, 1 to 25 (default 10; larger values are reduced to 25)."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "`nextCursor` from the previous page of the same search."
          }
        ],
        "responses": {
          "200": {
            "description": "One page of compact open jobs.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobSearchHitList"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Too many searches (over 120 searches with a `q` a minute from one IP address, counted across /jobs, /jobs/search and the MCP search tool together), or over 600 requests a minute in all; retry after the Retry-After seconds. `RateLimit-Policy` names the limit that was reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before the next call.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Limit": {
                "description": "Calls allowed a minute in the bucket that refused.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Calls left in this minute (0 on a 429).",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "Unix time, in seconds, when the bucket refills.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "RateLimit-Policy": {
                "description": "The refusing bucket as `<limit>;w=<window seconds>`, for example `600;w=60` or `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/jobs": {
      "get": {
        "operationId": "listJobs",
        "summary": "List the newest open jobs",
        "description": "Open jobs, newest first, without a search term. Returns compact jobs, 1 to 25 a page, paging with `cursor`. Use `searchJobs` when the person names the work they want.",
        "security": [],
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "view",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "compact"
              ],
              "default": "compact"
            },
            "description": "Always `compact`: jobs without descriptions or HTML."
          },
          {
            "name": "order",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "newest"
              ],
              "default": "newest"
            },
            "description": "Always `newest`: the most recently posted jobs first."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "Category slug from `GET /jobs/facets`."
          },
          {
            "name": "domain",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "Subject-matter domain slug from `GET /jobs/facets`."
          },
          {
            "name": "language",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 35
            },
            "description": "A language the work needs, as a tag such as `en`, `es` or `fil`."
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            },
            "description": "Two-letter ISO country of the person, such as `US`. Jobs with no country restriction are included."
          },
          {
            "name": "payType",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "PAY_PER_HOUR",
                "FIXED_PRICE",
                "PAY_PER_LABEL"
              ]
            },
            "description": "Payment type: hourly, fixed price or per label."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 25,
              "default": 10
            },
            "description": "Jobs per page, 1 to 25 (default 10; larger values are reduced to 25)."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 100
            },
            "description": "`nextCursor` from the previous page of the same list."
          }
        ],
        "responses": {
          "200": {
            "description": "One page of compact open jobs.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobSearchHitList"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests (over 600 a minute from one IP address, or, for a call that sends a `q`, over 120 searches a minute); retry after the Retry-After seconds. `RateLimit-Policy` names the limit that was reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before the next call.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Limit": {
                "description": "Calls allowed a minute in the bucket that refused.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Calls left in this minute (0 on a 429).",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "Unix time, in seconds, when the bucket refills.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "RateLimit-Policy": {
                "description": "The refusing bucket as `<limit>;w=<window seconds>`, for example `600;w=60` or `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/jobs/{id}": {
      "get": {
        "operationId": "getJob",
        "summary": "Read one job",
        "description": "One job in full (plain-text description, no HTML). A job that is closed or not public answers 404 with `{id, status: \"closed\"}`.",
        "security": [],
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Job id: from a search result, or the part after the last `--` of a job page URL."
          },
          {
            "name": "view",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "agent"
              ],
              "default": "agent"
            },
            "description": "Always `agent`: plain text, no HTML."
          }
        ],
        "responses": {
          "200": {
            "description": "The open job.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobAgentDetail"
                }
              }
            }
          },
          "400": {
            "description": "Invalid job id or view.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "The job is closed or not public (`status: \"closed\"`), or unknown.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/PublicJobClosed"
                    },
                    {
                      "$ref": "#/components/schemas/Error"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests (over 600 a minute from one IP address); retry after the Retry-After seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before the next call.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Limit": {
                "description": "Calls allowed a minute in the bucket that refused.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Calls left in this minute (0 on a 429).",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-RateLimit-Reset": {
                "description": "Unix time, in seconds, when the bucket refills.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "RateLimit-Policy": {
                "description": "The refusing bucket as `<limit>;w=<window seconds>`, for example `600;w=60` or `120;w=60`.",
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PublicJobSearchHitList": {
        "type": "object",
        "properties": {
          "jobs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Stable OpenTrain job id."
                },
                "url": {
                  "type": "string",
                  "description": "Canonical job page (https://www.opentrain.ai/jobs/<slug>--<id>/). Link this exactly; the person applies there."
                },
                "title": {
                  "type": "string"
                },
                "summary": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "One-line summary."
                },
                "category": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Category slug."
                },
                "domains": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Subject-matter domain slugs."
                },
                "languages": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Language tags the work needs."
                },
                "countries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "ISO 3166-1 alpha-2 codes. Empty means the job lists no country restriction."
                },
                "pay": {
                  "type": "object",
                  "properties": {
                    "paymentType": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "enum": [
                        "PAY_PER_HOUR",
                        "FIXED_PRICE",
                        "PAY_PER_LABEL",
                        null
                      ]
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "USD"
                      ]
                    },
                    "hourlyMin": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Hourly pay, low end (USD). A single rate is min = max."
                    },
                    "hourlyMax": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Hourly pay, high end (USD)."
                    },
                    "hourlyIsUpTo": {
                      "type": "boolean",
                      "description": "True when the hourly figures are a ceiling (\"up to\"), not the stated pay."
                    },
                    "fixedPrice": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Fixed price for the job (USD)."
                    },
                    "perLabelRate": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Pay per label (USD)."
                    }
                  },
                  "required": [
                    "paymentType",
                    "currency",
                    "hourlyMin",
                    "hourlyMax",
                    "hourlyIsUpTo",
                    "fixedPrice",
                    "perLabelRate"
                  ],
                  "additionalProperties": false
                },
                "employmentTypes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "schema.org employmentType values."
                },
                "workplace": {
                  "type": "string",
                  "enum": [
                    "remote"
                  ]
                },
                "datePosted": {
                  "type": "string",
                  "description": "ISO 8601 timestamp."
                },
                "validThrough": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "ISO 8601 timestamp until which the job is listed as open."
                },
                "updatedAt": {
                  "type": "string",
                  "description": "ISO 8601 timestamp."
                },
                "status": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "id",
                "url",
                "title",
                "summary",
                "category",
                "domains",
                "languages",
                "countries",
                "pay",
                "employmentTypes",
                "workplace",
                "datePosted",
                "validThrough",
                "updatedAt",
                "status"
              ],
              "additionalProperties": false
            }
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Pass as cursor for the next page; null when there are no more results."
          },
          "generatedAt": {
            "type": "string",
            "description": "ISO 8601 timestamp."
          }
        },
        "required": [
          "jobs",
          "nextCursor",
          "generatedAt"
        ],
        "additionalProperties": false
      },
      "PublicJobAgentDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable OpenTrain job id."
          },
          "url": {
            "type": "string",
            "description": "Canonical job page (https://www.opentrain.ai/jobs/<slug>--<id>/). Link this exactly; the person applies there."
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "One-line summary."
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Category slug."
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Subject-matter domain slugs."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Language tags the work needs."
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ISO 3166-1 alpha-2 codes. Empty means the job lists no country restriction."
          },
          "pay": {
            "type": "object",
            "properties": {
              "paymentType": {
                "type": [
                  "string",
                  "null"
                ],
                "enum": [
                  "PAY_PER_HOUR",
                  "FIXED_PRICE",
                  "PAY_PER_LABEL",
                  null
                ]
              },
              "currency": {
                "type": "string",
                "enum": [
                  "USD"
                ]
              },
              "hourlyMin": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Hourly pay, low end (USD). A single rate is min = max."
              },
              "hourlyMax": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Hourly pay, high end (USD)."
              },
              "hourlyIsUpTo": {
                "type": "boolean",
                "description": "True when the hourly figures are a ceiling (\"up to\"), not the stated pay."
              },
              "fixedPrice": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Fixed price for the job (USD)."
              },
              "perLabelRate": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Pay per label (USD)."
              }
            },
            "required": [
              "paymentType",
              "currency",
              "hourlyMin",
              "hourlyMax",
              "hourlyIsUpTo",
              "fixedPrice",
              "perLabelRate"
            ],
            "additionalProperties": false
          },
          "employmentTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "schema.org employmentType values."
          },
          "workplace": {
            "type": "string",
            "enum": [
              "remote"
            ]
          },
          "datePosted": {
            "type": "string",
            "description": "ISO 8601 timestamp."
          },
          "validThrough": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 timestamp until which the job is listed as open."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 timestamp."
          },
          "status": {
            "type": [
              "string",
              "null"
            ]
          },
          "descriptionText": {
            "type": "string",
            "description": "Plain-text job description. Never HTML."
          },
          "skills": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "labelTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "labelingSoftware": {
            "type": [
              "string",
              "null"
            ]
          },
          "dataType": {
            "type": [
              "string",
              "null"
            ]
          },
          "experienceLevel": {
            "type": [
              "string",
              "null"
            ]
          },
          "applyMode": {
            "type": "string",
            "enum": [
              "opentrain",
              "external"
            ],
            "description": "opentrain: the person applies through OpenTrain. external: the person signs up on OpenTrain first, then finishes on another site."
          }
        },
        "required": [
          "id",
          "url",
          "title",
          "summary",
          "category",
          "domains",
          "languages",
          "countries",
          "pay",
          "employmentTypes",
          "workplace",
          "datePosted",
          "validThrough",
          "updatedAt",
          "status",
          "descriptionText",
          "skills",
          "labelTypes",
          "labelingSoftware",
          "dataType",
          "experienceLevel",
          "applyMode"
        ],
        "additionalProperties": false
      },
      "PublicJobClosed": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "closed"
            ]
          }
        },
        "required": [
          "id",
          "status"
        ],
        "additionalProperties": false
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "error",
          "code"
        ]
      }
    }
  }
}