Jobven API

Jobven API as documented publicly: 9 operations. Contract generated from the documentation by API Evangelist (2026-11-13); not the provider's own document.

GitHub OpenAPI

Operations 9

GET / GET / #
GET /jobs/{jobid} GET /jobs/{jobId} #
GET /v1/public/companies GET /v1/public/companies #
GET /v1/public/companies/{id} GET /v1/public/companies/{id} returns one company in the same shape, or 404 . #
GET /v1/public/company-profiles GET /v1/public/company-profiles #
GET /v1/public/company-profiles/{id} Get a company profile by ID #
GET /v1/public/jobs GET /v1/public/jobs #
GET /v1/public/jobs/{id} Get Job by ID #
POST /your/webhook/path Webhooks - Jobven API #

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/jobven-com:jobven-com-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

jobven-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Jobven API
  version: '2026-11-13'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-13: 9 operation(s) read from 8 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Jobven has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 5
    documentation: 4
    pages-with-code: 5
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-13'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://jobven.com/docs/reference/jobs
  - https://jobven.com/docs/reference/overview
  - https://api.jobven.com/api/docs/public-json
  - https://jobven.com/docs/reference/companies
  - https://jobven.com/docs/reference/data-types
  - https://jobven.com/docs/reference/api-stability
  - https://jobven.com/docs/webhooks/event-reference
  - https://jobven.com/docs/webhooks
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://jobven.com/docs/reference/overview
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl Guides Filter Jobs Fetch All Jobs Incremental Sync Rate Limits Build a Job Board Webhooks Webhooks Event reference Marketplaces
          Apify and RapidAPI MCP server MCP server API Reference Jobven API reference. Base URL, authentication, response format, and error codes
          for all endpoints. The Jobven API provides programmatic access to job listings and company data. All endpoints follow REST conventi
  /jobs/{jobid}:
    get:
      operationId: get_jobs_jobid
      tags:
      - Jobs
      summary: GET /jobs/{jobId}
      x-source: https://jobven.com/docs/webhooks/event-reference
      parameters:
      - name: jobid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Guides Filter Jobs Fetch All Jobs Incremental Sync Rate Limits Build a Job Board Webhooks Webhooks Event reference Marketplaces\
          \ Apify and RapidAPI MCP server MCP server Event reference [object Object] Every webhook delivery shares the same envelope: {\n \" id\
          \ \" : \" 8e3f5c44-1cd1-4a40-bb4f-9d4f95c54c1d \" ,\n \" type \" : \" job.created \" ,\n \" version \" : \" 2026-10-30 \" ,\n \" createdAt\
          \ \" : 1715520000 "
  /v1/public/companies:
    get:
      operationId: get_v1_public_companies
      tags:
      - Public
      summary: GET /v1/public/companies
      x-source: https://jobven.com/docs/reference/companies
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: search
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicCompaniesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Guides Filter Jobs Fetch All Jobs Incremental Sync Rate Limits Build a Job Board Webhooks Webhooks Event reference Marketplaces
          Apify and RapidAPI MCP server MCP server Companies Find companies by name for free, and read their profiles (industry, size, founding
          year, headquarters) from the Jobven API. Two endpoints serve companies. /companies finds companies by name and returns who they are, '
  /v1/public/companies/{id}:
    get:
      operationId: get_v1_public_companies_id
      tags:
      - Public
      summary: GET /v1/public/companies/{id} returns one company in the same shape, or 404 .
      description: Returns one company in the same shape as List Companies, or 404.
      x-source: https://jobven.com/docs/reference/companies
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicCompaniesIdResponse'
      x-evidence:
        kind: documentation
  /v1/public/company-profiles:
    get:
      operationId: get_v1_public_company_profiles
      tags:
      - Public
      summary: GET /v1/public/company-profiles
      x-source: https://jobven.com/docs/reference/companies
      parameters:
      - name: industry
        in: query
        required: false
        schema:
          type: string
      - name: maxEmployees
        in: query
        required: false
        schema:
          type: string
      - name: minEmployees
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicCompanyProfilesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \" X-API-Key: $JOBVEN_API_KEY \"  \" https://api.jobven.com/v1/public/company-profiles?industry=technology_software&minEmployees=200&maxEmployees=1000\
          \ \"\n Query Parameters Every parameter of List Companies , with search matching the name, the website or the description, plus: Parameter\
          \ Type Description industry string Companies in any of these industries, up to 10. Same keys as a job's industr"
  /v1/public/company-profiles/{id}:
    get:
      operationId: get_v1_public_company_profiles_id
      tags:
      - Public
      summary: Get a company profile by ID
      description: One company with its profile. Counts as one toward the monthly allowance.
      x-source: https://api.jobven.com/api/docs/public-json
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicCompanyProfilesIdResponse'
      x-evidence:
        kind: documentation
  /v1/public/jobs:
    get:
      operationId: get_v1_public_jobs
      tags:
      - Public
      summary: GET /v1/public/jobs
      x-source: https://jobven.com/docs/reference/jobs
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: remoteType[]
        in: query
        required: false
        schema:
          type: string
      - name: skills[]
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Guides Filter Jobs Fetch All Jobs Incremental Sync Rate Limits Build a Job Board Webhooks Webhooks Event reference Marketplaces\
          \ Apify and RapidAPI MCP server MCP server Jobs Search and retrieve job listings. Filter by skills, location, remote type, salary, and\
          \ more. The Jobs endpoint lets you search and retrieve job listings with powerful filtering options. List Jobs GET /v1/public/jobs\n\
          \ Retu"
  /v1/public/jobs/{id}:
    get:
      operationId: get_v1_public_jobs_id
      tags:
      - Public
      summary: Get Job by ID
      description: Retrieve a single job by its UUID.
      x-source: https://jobven.com/docs/reference/jobs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicJobsIdResponse'
      x-evidence:
        kind: documentation
  /your/webhook/path:
    post:
      operationId: post_your_webhook_path
      tags:
      - Your
      summary: Webhooks - Jobven API
      x-source: https://jobven.com/docs/webhooks
      parameters:
      - name: Content-Type
        in: header
        required: true
        schema:
          type: string
        description: application/json; charset=utf-8
      - name: User-Agent
        in: header
        required: true
        schema:
          type: string
        description: Jobven-Webhooks/1.0
      - name: Jobven-Event
        in: header
        required: true
        schema:
          type: string
        description: The event type, such as job.created
      - name: Jobven-Event-Id
        in: header
        required: true
        schema:
          type: string
        description: The event's ID, the same across every retry
      - name: Jobven-Subscription-Id
        in: header
        required: true
        schema:
          type: string
        description: The subscription the delivery belongs to
      - name: Jobven-Delivery-Id
        in: header
        required: true
        schema:
          type: string
        description: This delivery's ID, the same across its retries
      - name: Jobven-Delivery-Attempt
        in: header
        required: true
        schema:
          type: integer
        description: Attempt number, 1 on the first attempt
      - name: Jobven-Webhook-Version
        in: header
        required: true
        schema:
          type: string
        description: The payload version, same as body version
      - name: Jobven-Signature
        in: header
        required: true
        schema:
          type: string
        description: HMAC signature, format t=<unix>,v1=<hex>
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostYourWebhookPathRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetResponse:
      type: object
      properties:
        ' data ':
          type: array
          items: {}
        ' meta ':
          type: object
          properties:
            ' count ':
              type: integer
            ' nextCursor ':
              type: string
            ' hasMore ':
              type: boolean
    GetV1PublicCompaniesResponse:
      type: object
      properties:
        ' data ':
          type: array
          items:
            type: object
            properties:
              ' id ':
                type: integer
              ' name ':
                type: string
              ' website ':
                type: string
        ' meta ':
          type: object
          properties:
            ' page ':
              type: integer
            ' limit ':
              type: integer
            ' total ':
              type: integer
            ' totalPages ':
              type: integer
    GetV1PublicCompaniesIdResponse:
      type: object
      properties:
        data:
          type: object
          description: Company object with id, name, website
    GetV1PublicCompanyProfilesResponse:
      type: object
      properties:
        ' data ':
          type: array
          items:
            type: object
            properties:
              ' id ':
                type: integer
              ' name ':
                type: string
              ' website ':
                type: string
              ' description ':
                type: string
              ' industry ':
                type: string
              ' size ':
                type: string
              ' sizeMin ':
                type: integer
              ' sizeMax ':
                type: integer
              ' sizeSource ':
                type: string
              ' foundedYear ':
                type: integer
              ' headquarters ':
                type: object
                properties:
                  ' city ':
                    type: string
                  ' state ':
                    type: string
                  ' country ':
                    type: string
              ' linkedinUrl ':
                type: string
              ' twitterUrl ':
                type:
                - string
                - 'null'
              ' githubUrl ':
                type: string
              ' profileUpdatedAt ':
                type: integer
        ' meta ':
          type: object
          properties:
            ' page ':
              type: integer
            ' limit ':
              type: integer
            ' total ':
              type: integer
            ' totalPages ':
              type: integer
    GetV1PublicCompanyProfilesIdResponse:
      type: object
      properties:
        '200':
          type: string
          description: Successfully retrieved company profile
        '404':
          type: string
          description: Company not found
    GetV1PublicJobsIdResponse:
      type: object
      properties:
        data:
          type: object
          description: A single job object (same schema as list response items).
    PostYourWebhookPathRequest:
      type: object
      properties:
        id:
          type: string
          description: Event ID
        type:
          type: string
          description: Event type, e.g., job.created
        version:
          type: string
          description: Payload version date
        createdAt:
          type: integer
          description: Unix timestamp of creation
        subscriptionId:
          type: string
          description: Subscription ID
        deliveryAttempt:
          type: integer
          description: Delivery attempt number
        data:
          type: object
          description: Payload data, contains job object
      required:
      - id
      - type
      - version
      - createdAt
      - subscriptionId
      - deliveryAttempt
      - data
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
security:
- apiKey: []
tags:
- name: Api
- name: Jobs
- name: Public
- name: Your