veritahire-com Hiring velocity API

openapi: 3.2.0
info:
  title: VeritaHire Hiring velocity API
  version: 1.0.0
  description: 'Live US job postings verified on each employer''s own careers site and retired within about 36 hours of leaving it. FREE, NO KEY: search live jobs, read a whole posting, check whether a posting is still open, the Competitive Hiring Report for a healthcare, finance, IT, engineering, science, HR, legal, marketing, sales, customer service, admin, operations and logistics, skilled trades, retail and food, or education role (competitors'' close times and pay). WITH A KEY (self-serve 2,000-record trial at https://veritahire.com/developers/): the full Verified Jobs Feed - every live posting, cursor-paged, plus per-employer hiring velocity and employer profiles. An MCP server with the free tools is at https://veritahire.com/mcp. Data source: public postings on employers'' own career sites.'
servers:
- url: https://veritahire.com
tags:
- name: Hiring velocity
paths:
  /api/v1/velocity.php:
    get:
      tags:
      - Hiring velocity
      summary: Per-employer daily hiring velocity (new / retired / live)
      description: Either one employer's full series (employer_id, optional from/to) or every employer for one day (date, cursor-paged by employer_id). The identity live(d) = live(d-1) + new(d) - retired(d) holds exactly. partial = 1 on days before 2026-06-29 where retirements are incomplete. Each row counts as one record against the monthly quota.
      operationId: velocity
      parameters:
      - name: employer_id
        in: query
        description: One employer's series.
        schema:
          type: integer
      - name: from
        in: query
        description: YYYY-MM-DD (with employer_id).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: YYYY-MM-DD (with employer_id).
        schema:
          type: string
          format: date
      - name: date
        in: query
        description: 'YYYY-MM-DD: every employer for this day.'
        schema:
          type: string
          format: date
      - name: after
        in: query
        description: employer_id cursor (with date).
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: Rows per page, 1-500 (with date).
        schema:
          type: integer
          default: 500
          maximum: 500
      responses:
        '200':
          description: Velocity rows
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VelocityPage'
              example:
                data:
                - employer_id: 812
                  employer: Lowe's
                  date: '2026-09-07'
                  new_postings: 1093
                  retired_postings: 1288
                  live_postings: 12402
                  partial: 0
                count: 1
                next_after: null
                quota:
                  used: 1
                  limit: 50000
                  resets: '2026-10-01'
        '401':
          description: Missing, unknown or revoked key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Per-minute limit or monthly quota reached
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    VelocityPage:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/VelocityRow'
        count:
          type: integer
        next_after:
          type: integer
          nullable: true
        quota:
          $ref: '#/components/schemas/Quota'
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
    Quota:
      type: object
      properties:
        used:
          type: integer
        limit:
          type: integer
          nullable: true
        resets:
          type: string
          nullable: true
    VelocityRow:
      type: object
      properties:
        employer_id:
          type: integer
        employer:
          type: string
        date:
          type: string
          format: date
        new_postings:
          type: integer
        retired_postings:
          type: integer
        live_postings:
          type: integer
        partial:
          type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Your vh_... key. Free trial (2,000 credits; 1 credit = 1 job returned), then $3.95 per 1,000: https://veritahire.com/verified-jobs-feed/'