List Job Facets

Aggregate counts across the open marketplace — categories, languages, countries, and pay types, each with the number of matching jobs. Use these to populate filter dropdowns or to discover valid filter values for GET /jobs instead of guessing strings.

Tokenless, CORS-enabled, and edge-cached the same way as the search endpoint.

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

Request

No parameters. OPTIONS returns 204 (CORS preflight).

Response

totalJobsnumber

Total open jobs in the marketplace.

categoriesobject[]

{value, count} pairs, sorted by count descending.

languagesobject[]

{value, count} pairs, sorted by count descending.

countriesobject[]

{value, count} pairs, sorted by count descending.

payTypesobject[]

{value, count} pairs — values are PAY_PER_HOUR, FIXED_PRICE, PAY_PER_LABEL.

generatedAtstring

ISO timestamp when the counts were computed.

Errors

Status	code	Meaning
429	RATE_LIMITED	Over 120 requests/minute from one IP

Request examples

curl

curl -sS https://app.opentrain.ai/api/public/v1/jobs/facets

Response examples

200

{
  "totalJobs": 184,
  "categories": [
    { "value": "Text Annotation", "count": 62 },
    { "value": "Audio Annotation", "count": 41 },
    { "value": "Image Annotation", "count": 35 }
  ],
  "languages": [
    { "value": "English", "count": 120 },
    { "value": "Spanish", "count": 28 }
  ],
  "countries": [
    { "value": "US", "count": 44 },
    { "value": "IN", "count": 31 }
  ],
  "payTypes": [
    { "value": "PAY_PER_HOUR", "count": 97 },
    { "value": "PAY_PER_LABEL", "count": 52 },
    { "value": "FIXED_PRICE", "count": 35 }
  ],
  "generatedAt": "2026-06-12T08:00:00.000Z"
}