SalesJobs.Now Roles.json API

openapi: 3.2.0
info:
  title: SalesJobs.Now sales job data Roles.json API
  version: 1.0.0
  summary: Open sales roles counted by kind of sales work and by company, with the pay each posting states.
  description: 'Read-only figures and search over open sales jobs (SDR and BDR, account executive, account manager, customer success, sales engineering, sales leadership and more), taken from the careers systems of the companies hiring. Free, no key, CORS on. Every field is explained at https://salesjobs.now/data. Licensed CC BY 4.0: name SalesJobs.Now as the source and quote the day in temporal_coverage. Assistants can query the same figures over MCP at https://salesjobs.now/api/mcp.'
  contact:
    name: SalesJobs.Now
    url: https://salesjobs.now/data
  license:
    name: CC BY 4.0
    identifier: CC-BY-4.0
servers:
- url: https://salesjobs.now
tags:
- name: Roles.json
paths:
  /roles.json:
    get:
      operationId: getOpenRoles
      summary: Sales openings by kind of sales work and by company
      description: 'A count of the sales roles open today, the ones that first appeared over the past 7 days and in each recent ISO week, split by kind of sales work and by hiring company, with a pay band wherever three or more companies post one. Totals only: no single posting is included.'
      responses:
        '200':
          description: The openings document, dated by temporal_coverage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RolesDocument'
      tags:
      - Roles.json
components:
  schemas:
    PayBand:
      type: object
      properties:
        currency:
          type:
          - string
          - 'null'
          examples:
          - USD
        unit:
          type:
          - string
          - 'null'
          examples:
          - per year
        median:
          type:
          - number
          - 'null'
        typical_low:
          type:
          - number
          - 'null'
          description: 25th percentile of the posted pay figures.
        typical_high:
          type:
          - number
          - 'null'
          description: 75th percentile of the posted pay figures.
        rate_samples:
          type:
          - integer
          - 'null'
          description: How many distinct posted pay figures went in, with reposted roles counted once.
        platforms:
          type:
          - integer
          - 'null'
          description: How many companies posted those figures.
    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
    DocumentInfo:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        source:
          type: string
          format: uri
          description: The page on the site that shows these same figures.
        license:
          type: string
          format: uri
        measurement_technique:
          type: string
        updated:
          type: string
          format: date-time
          description: The last time the companies' careers systems were read, in UTC.
        temporal_coverage:
          type: string
          format: date
          description: The date these figures belong to; quote it when you cite them.
externalDocs:
  description: What each field means, and the terms of use
  url: https://salesjobs.now/data