Noozra Jobs API

Open jobs from employers' own job boards, jobs posted on Noozra, and remote-job boards.

GitHub OpenAPI

Operations 2

GET /api/jobs List job listings #
GET /api/jobs/{id} One job listing #

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/noozra:noozra-jobs-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.

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

OpenAPI Specification

noozra-jobs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Noozra Jobs API
  version: 1.4.0
  contact:
    name: Noozra
    url: https://noozra.com
  termsOfService: https://noozra.com/terms
  description: 'Operations tagged Jobs across 2 of this provider''s published API definitions: noozra-openapi.json, noozra-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://noozra.com
security:
- bearerAuth: []
tags:
- description: Open jobs from employers' own job boards, jobs posted on Noozra, and remote-job boards.
  name: Jobs
paths:
  /api/jobs:
    get:
      description: 'Newest-first job listings: jobs read from employers'' own job boards, jobs posted on Noozra, and jobs from We Work Remotely, RemoteOK and Arbeitnow. A listing from another job board carries what identifies the job and a link to the original, never its text; an employer''s own listing carries the first 500 characters of its text and its posting as `apply_url`; a job posted on Noozra carries its description and application link. Cursor-paginate by passing the previous response''s `next_before` + `next_before_id` back as `before` + `before_id`. Open listings posted in the last 14 days for every caller; API Pro reaches every listing, and closed ones with `include_closed=true`.'
      operationId: listJobs
      parameters:
      - description: Category slug (see /api/categories). A listing filed under every category matches any slug.
        in: query
        name: category
        required: false
        schema:
          type: string
      - description: '`true`: only fully remote listings.'
        in: query
        name: remote
        required: false
        schema:
          type: boolean
      - description: ISO 3166-1 alpha-2 code, such as DE. Matches only listings that name a country. An employer's listing names one when its location does ("Austin, TX", "London, UK"); listings from other job boards name none.
        in: query
        name: country
        required: false
        schema:
          maxLength: 2
          minLength: 2
          type: string
      - description: Text to find in the job title or company name.
        in: query
        name: q
        required: false
        schema:
          maxLength: 200
          type: string
      - description: 'Only this company''s listings: its whole name, any case, such as `stripe`.'
        in: query
        name: company
        required: false
        schema:
          maxLength: 200
          type: string
      - description: '`true`: only listings read from employers'' own job boards.'
        in: query
        name: from_employer
        required: false
        schema:
          default: false
          type: boolean
      - description: '`true`: also listings past their closing date. Needs API Pro (403 otherwise).'
        in: query
        name: include_closed
        required: false
        schema:
          default: false
          type: boolean
      - description: Only listings posted after this time. Within the last 14 days for every caller; earlier needs API Pro (403 otherwise).
        in: query
        name: after
        required: false
        schema:
          format: date-time
          type: string
      - description: ISO 8601 cursor; pass `next_before` from the previous page.
        in: query
        name: before
        required: false
        schema:
          format: date-time
          type: string
      - description: Tuple-cursor companion to `before` (pass `next_before_id`).
        in: query
        name: before_id
        required: false
        schema:
          format: uuid
          type: string
      - description: Items to return; clamped to 1–100.
        in: query
        name: limit
        required: false
        schema:
          default: 20
          maximum: 100
          minimum: 1
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobsResponse'
          description: OK
          headers:
            X-Noozra-Plan:
              $ref: '#/components/headers/X-Noozra-Plan'
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '400':
          description: Unknown category, a country that is not an ISO 3166-1 alpha-2 code, a `q` or `company` over 200 characters, a `remote`, `from_employer` or `include_closed` other than true or false, or a date outside 1970–9999
        '401':
          description: No API key, or an invalid or revoked one
        '403':
          description: '`after` reaches past the last 14 days, or `include_closed=true` was asked: both need API Pro'
        '429':
          description: Daily rate limit exceeded (honor the Retry-After header)
      security:
      - bearerAuth: []
      summary: List job listings
      tags:
      - Jobs
    servers:
    - url: https://noozra.com
  /api/jobs/{id}:
    get:
      description: One listing, in the shape `/api/jobs` lists it. Without API Pro, an open listing posted in the last 14 days; with it, any listing, closed ones included.
      operationId: getJob
      parameters:
      - description: A listing's `id`.
        in: path
        name: id
        required: true
        schema:
          format: uuid
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
          description: OK
          headers:
            X-Noozra-Plan:
              $ref: '#/components/headers/X-Noozra-Plan'
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '400':
          description: Not a UUID
        '401':
          description: No API key, or an invalid or revoked one
        '404':
          description: Unknown listing (or, without API Pro, one posted more than 14 days ago or closed)
        '429':
          description: Daily rate limit exceeded (honor the Retry-After header)
      security:
      - bearerAuth: []
      summary: One job listing
      tags:
      - Jobs
    servers:
    - url: https://noozra.com
components:
  headers:
    X-RateLimit-Remaining:
      description: Requests this key has left today.
      schema:
        type: integer
    X-Noozra-Plan:
      description: 'The key''s plan: free (personal and non-commercial use) or pro (commercial use of the API).'
      schema:
        type: string
    X-RateLimit-Limit:
      description: Requests this key may make today. Sent on answers to a request with a key.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: Unix time, in seconds, of the next 00:00 UTC, when every count starts again.
      schema:
        type: integer
  schemas:
    Job:
      properties:
        apply_url:
          description: 'Only for an employer''s own listing or a job posted on Noozra: where to apply.'
          format: uri
          type: string
        categories:
          description: Category slugs; ["any"] = listed under every category.
          items:
            type: string
          type: array
        company:
          type: string
        country:
          description: ISO 3166-1 alpha-2 when the listing names a country; else null. An employer's listing names one when its location does; listings from other job boards name none.
          type:
          - string
          - 'null'
        description:
          description: 'Only for an employer''s own listing (its first 500 characters) or a job posted on Noozra: the employer''s own text. A listing from another job board never carries its text; follow `url`.'
          type: string
        employment_type:
          description: schema.org employmentType, or null when the listing did not say.
          enum:
          - FULL_TIME
          - PART_TIME
          - CONTRACTOR
          - TEMPORARY
          - INTERN
          - OTHER
          - null
          type:
          - string
          - 'null'
        expires_at:
          description: When the listing closes.
          format: date-time
          type: string
        from_employer:
          description: Read from the employer's own job board.
          type: boolean
        hybrid:
          description: Part on site, part remote. Never true alongside `remote`.
          type: boolean
        id:
          format: uuid
          type: string
        location:
          description: Where the job is, as the listing says ("Remote" for most).
          type: string
        noozra_url:
          description: The listing's page on Noozra.
          format: uri
          type: string
        posted_at:
          format: date-time
          type: string
        remote:
          description: Fully remote.
          type: boolean
        salary:
          $ref: '#/components/schemas/JobSalary'
          description: Only when the listing gives a salary.
        source:
          description: 'Where the listing comes from: "{Company} careers" for an employer''s own job board, We Work Remotely, RemoteOK, Arbeitnow, or Noozra. Name it when you show the listing.'
          type: string
        title:
          type: string
        url:
          description: The original listing; for a job posted on Noozra, its Noozra page. Link to this.
          format: uri
          type: string
      required:
      - id
      - title
      - company
      - location
      - country
      - remote
      - hybrid
      - employment_type
      - categories
      - posted_at
      - expires_at
      - source
      - from_employer
      - url
      - noozra_url
      type: object
    JobsResponse:
      properties:
        count:
          type: integer
        jobs:
          items:
            $ref: '#/components/schemas/Job'
          type: array
        next_before:
          description: Pass as `before` for the next page; null at the end.
          format: date-time
          type:
          - string
          - 'null'
        next_before_id:
          description: Pass as `before_id` with `before`.
          format: uuid
          type:
          - string
          - 'null'
      required:
      - jobs
      - count
      - next_before
      - next_before_id
      type: object
    JobSalary:
      properties:
        currency:
          description: ISO 4217, such as USD.
          type:
          - string
          - 'null'
        max:
          type:
          - integer
          - 'null'
        min:
          type:
          - integer
          - 'null'
      type: object
  securitySchemes:
    bearerAuth:
      description: 'API key (nk_…), from a free account: https://noozra.com/register?next=%2Faccount%2Fapi. A new free key needs a card saved to the account; saving it charges nothing. Free (100/day, personal and non-commercial use) or API Pro (25,000/day, commercial use of the API and the archive). Required on every request except /api/categories and /api/datasets.'
      scheme: bearer
      type: http
x-refined-from:
- noozra-openapi.json
- noozra-openapi.json