AITraining.jobs

AITraining.jobs Roles.json API

The Roles.json API from AITraining.jobs — 1 operation(s) for roles.json.

Documentation GitHub OpenAPI

Operations 1

GET /roles.json Open roles by kind of work and platform #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/aitraining-jobs/openapi/aitraining-jobs-roles-json-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/aitraining-jobs:aitraining-jobs-roles-json-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: AITraining.jobs open data Roles.json API
  version: 1.0.0
  summary: 'AI training job market data: open roles by kind of work and platform, and advertised hourly pay.'
  description: 'Free, read-only data on AI training jobs (paid work training, evaluating and labeling data for AI models), measured daily from about 17 platforms'' public job feeds. No key, CORS enabled. Field reference: https://aitraining.jobs/data . License CC BY 4.0: credit AITraining.jobs and cite the date in temporal_coverage. The same data is available to AI assistants as a remote MCP server at https://aitraining.jobs/api/mcp .'
  contact:
    name: AITraining.jobs
    url: https://aitraining.jobs/data
    email: hello@aitraining.jobs
  license:
    name: CC BY 4.0
    identifier: CC-BY-4.0
servers:
- url: https://aitraining.jobs
tags:
- name: Roles.json
paths:
  /roles.json:
    get:
      operationId: getOpenRoles
      summary: Open roles by kind of work and platform
      description: 'How many AI training roles are open now, how many were first listed in the last 7 days and in each recent ISO week, and open roles by kind of work and by platform, with pay where at least three platforms advertise a rate. Aggregates only: no individual roles.'
      responses:
        '200':
          description: The open-roles document for the day in temporal_coverage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RolesDocument'
      tags:
      - Roles.json
components:
  schemas:
    RolesDocument:
      allOf:
      - $ref: '#/components/schemas/DocumentInfo'
      - type: object
        properties:
          totals:
            type: object
            properties:
              open_roles:
                type: integer
              platforms_live:
                type: integer
              new_last_7d:
                type: integer
              new_last_7d_measurement:
                type: string
          recent_market_momentum:
            type:
            - object
            - 'null'
            properties:
              unit:
                type: string
              measurement:
                type: string
              avg_new_roles_per_week:
                type: number
              weeks_measured:
                type: integer
              weekly:
                type: array
                items:
                  type: object
                  properties:
                    week_start:
                      type: string
                      format: date
                    new_roles:
                      type: integer
          open_by_work_type:
            type: array
            items:
              allOf:
              - $ref: '#/components/schemas/PayBand'
              - type: object
                properties:
                  slug:
                    type: string
                  label:
                    type: string
                  open_count:
                    type: integer
          open_by_platform:
            type: array
            items:
              type: object
              properties:
                slug:
                  type: string
                name:
                  type: string
                open_count:
                  type: integer
    PayBand:
      type: object
      properties:
        currency:
          type:
          - string
          - 'null'
          examples:
          - USD
        unit:
          type:
          - string
          - 'null'
          examples:
          - per hour
        median:
          type:
          - number
          - 'null'
        typical_low:
          type:
          - number
          - 'null'
          description: 25th percentile of advertised rates.
        typical_high:
          type:
          - number
          - 'null'
          description: 75th percentile of advertised rates.
        rate_samples:
          type:
          - integer
          - 'null'
          description: Distinct advertised rates measured, after removing relistings.
        platforms:
          type:
          - integer
          - 'null'
          description: Platforms advertising those rates.
    DocumentInfo:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        source:
          type: string
          format: uri
          description: The page that renders the same numbers.
        license:
          type: string
          format: uri
        measurement_technique:
          type: string
        updated:
          type: string
          format: date-time
          description: When the job feeds were last read (UTC).
        temporal_coverage:
          type: string
          format: date
          description: The day the figures describe. Cite this date.
externalDocs:
  description: Field reference and terms
  url: https://aitraining.jobs/data