veritahire-com Employer profile API

openapi: 3.2.0
info:
  title: VeritaHire Employer profile 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: Employer profile
paths:
  /api/v1/employers.php:
    get:
      tags:
      - Employer profile
      summary: Employer profile companion table - one row per employer with live postings
      description: 'Joins to postings on employer_id. No field is inferred by a model: every non-null value has an evidence row naming its source (People Data Labs free company dataset CC BY 4.0 joined on the employer domain, SEC EDGAR, or the employer''s own pages). Each row counts as one record against the monthly quota.'
      operationId: employers
      parameters:
      - name: after
        in: query
        description: employer_id cursor.
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: Rows per page, 1-500.
        schema:
          type: integer
          default: 100
          maximum: 500
      - name: id
        in: query
        description: One employer.
        schema:
          type: integer
      - name: hq_state
        in: query
        description: Two-letter state.
        schema:
          type: string
      - name: org_kind
        in: query
        description: public | private | nonprofit | government | education
        schema:
          type: string
      - name: size
        in: query
        description: 'Headcount band: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+'
        schema:
          type: string
      - name: industry
        in: query
        description: Substring match on industry.
        schema:
          type: string
      - name: public
        in: query
        description: 1 = public companies (has an SEC ticker).
        schema:
          type: integer
      - name: platform
        in: query
        description: ATS the board is read from.
        schema:
          type: string
      responses:
        '200':
          description: Employer rows
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmployersPage'
        '401':
          description: Missing or bad key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited or quota exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    EmployersPage:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/EmployerRow'
        count:
          type: integer
        next_after:
          type: integer
          nullable: true
        quota:
          $ref: '#/components/schemas/Quota'
    EmployerRow:
      type: object
      properties:
        employer_id:
          type: integer
        employer:
          type: string
        live_postings:
          type: integer
        platform:
          type: string
          nullable: true
        org_kind:
          type: string
          nullable: true
        industry:
          type: string
          nullable: true
        size_range:
          type: string
          nullable: true
        hq_city:
          type: string
          nullable: true
        hq_state:
          type: string
          nullable: true
        hq_country:
          type: string
          nullable: true
        founded_year:
          type: integer
          nullable: true
        website:
          type: string
          nullable: true
        linkedin_url:
          type: string
          nullable: true
        ticker:
          type: string
          nullable: true
        exchange:
          type: string
          nullable: true
        cik:
          type: integer
          nullable: true
        sic:
          type: integer
          nullable: true
        sic_label:
          type: string
          nullable: true
        state_inc:
          type: string
          nullable: true
        latest_10k_date:
          type: string
          format: date
          nullable: true
        latest_10k_url:
          type: string
          nullable: true
        profile_sources:
          type: object
          nullable: true
          description: 'The source of every non-null field: pdl (People Data Labs, CC BY 4.0), sec (SEC EDGAR), or the employer''s own page.'
    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
  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/'