SalesJobs.Now Jobs API

openapi: 3.2.0
info:
  title: SalesJobs.Now sales job data Jobs 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: Jobs
paths:
  /api/v1/jobs:
    get:
      operationId: searchJobs
      summary: Search open sales jobs
      description: Open sales roles from the companies SalesJobs.Now follows, each with its posted pay and a link to its page on SalesJobs.Now, where the user applies. All filters are optional. Always show the user each role's url.
      parameters:
      - name: q
        in: query
        required: false
        description: Words matched against role titles, for example account executive, SDR, enterprise or healthcare.
        schema:
          type: string
          maxLength: 120
      - name: kind
        in: query
        required: false
        description: One kind of sales work by its slug (roles.json lists each with its label), or several joined by commas.
        schema:
          type: string
          enum:
          - sales-development
          - account-executive
          - account-management
          - customer-success
          - sales-engineering
          - partner-sales
          - revenue-operations
          - sales-leadership
      - name: platform
        in: query
        required: false
        description: One hiring company by its slug (roles.json lists them).
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: Two-letter ISO 3166-1 code that keeps only roles open to people in that country, for example US, GB or CA.
        schema:
          type: string
          minLength: 2
          maxLength: 2
      - name: min_pay_usd
        in: query
        required: false
        description: Keeps only roles whose posted pay reaches at least this many US dollars a year at the top of its range (a posting quoted per hour counts at 2,080 hours).
        schema:
          type: integer
          minimum: 1
          maximum: 4160000
      - name: min_hourly_usd
        in: query
        required: false
        description: The same floor given per hour, multiplied by 2,080 hours to make a year.
        schema:
          type: integer
          minimum: 1
          maximum: 2000
      - name: since
        in: query
        required: false
        description: Keeps only roles that first appeared on or after this date (YYYY-MM-DD).
        schema:
          type: string
          format: date
      - name: sort
        in: query
        required: false
        description: 'balanced (default: the site''s single role order, which weighs how many people apply to a role against how often it is seen, and never sells placement), recent (newest first) or pay (best paid first).'
        schema:
          type: string
          enum:
          - balanced
          - recent
          - pay
          default: balanced
      - name: limit
        in: query
        required: false
        description: Number of roles to return, from 1 to 50.
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 20
      - name: offset
        in: query
        required: false
        description: Roles to skip, to page through the results.
        schema:
          type: integer
          minimum: 0
          default: 0
      - name: src
        in: query
        required: false
        description: A short slug naming your app; it rides along on every role link.
        schema:
          type: string
          maxLength: 40
      responses:
        '200':
          description: The roles that match, in the site's role order unless you sort them.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobsResult'
        '400':
          description: A filter names a kind, a company or a country the board does not know; the error field says which.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Jobs
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
      - error
    PublicRole:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        platform:
          type: string
          description: The hiring company
        platform_slug:
          type: string
        kind:
          type:
          - string
          - 'null'
          description: Kind of sales work
        kind_slug:
          type:
          - string
          - 'null'
        pay:
          type:
          - string
          - 'null'
          description: The pay the posting states; when it states none, the company's usual range, labelled as such in the text
        location:
          type:
          - string
          - 'null'
        remote:
          type: boolean
        listed:
          type: string
          format: date
        first_seen_at:
          type: string
          format: date-time
        url:
          type: string
          format: uri
          description: The role's page on SalesJobs.Now, the place to apply
      required:
      - id
      - title
      - platform
      - platform_slug
      - remote
      - listed
      - first_seen_at
      - url
    JobsResult:
      type: object
      properties:
        total:
          type:
          - integer
          - 'null'
          description: Number of open roles that match
        roles:
          type: array
          items:
            $ref: '#/components/schemas/PublicRole'
        more:
          type: string
          format: uri
      required:
      - roles
externalDocs:
  description: What each field means, and the terms of use
  url: https://salesjobs.now/data