> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Job Insights

> Aggregated hiring-signal insights for a company over a date window: posting volume, seniority distribution, top functions/departments/locations, and a weekly time series.



## OpenAPI

````yaml en-openapi POST /companies/jobs/insights
openapi: 3.0.0
info:
  description: >-
    The Pubrio API delivers market expansion intelligence — real-time signals
    that flag when a company enters a new market — alongside the company and
    people data beneath them. Search, look up, and enrich accounts and contacts,
    and subscribe to typed, dated movement signals across 200+ markets.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/en/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/en/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: Workspace profile information and usage statistics
  - name: Enrichment
    description: Enrich people and company records with detailed B2B data
  - name: Lookalike
    description: Find companies similar to a given company
  - name: Search
    description: Search for people, companies, jobs, news, and advertisements with filters
  - name: Lookup
    description: >-
      Look up detailed information for specific people, companies, jobs, news,
      advertisements, and technologies
  - name: LinkedIn
    description: Look up people and company data via LinkedIn profile URLs
  - name: Redeem
    description: Redeem credits to unlock people contact details (single and batch)
  - name: Channels
    description: Manage outreach channel templates (create, update, delete, list)
  - name: Monitor
    description: Create and manage data monitors with webhooks, statistics, and processing
  - name: Filters
    description: >-
      Retrieve available filter values for search parameters (technologies,
      locations, verticals, etc.)
  - name: API Keys
    description: List and inspect API request logs and usage analytics for API keys
  - name: Insights
    description: Aggregated signal insights for companies (jobs, news, advertisements).
  - name: Export
    description: Bulk data exports (credit-gated).
  - name: Expansion
    description: >-
      Company market-expansion intelligence: signals, stages, markets, and
      exports.
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /companies/jobs/insights:
    post:
      tags:
        - Insights
      summary: Job posting insights
      description: >-
        Aggregated hiring-signal insights for a company over a date window:
        posting volume, seniority distribution, top
        functions/departments/locations, and a weekly time series.
      operationId: companies_jobs_insights
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - domain_search_id
              properties:
                domain_search_id:
                  $ref: '#/components/schemas/domain_search_id'
                date_from:
                  $ref: '#/components/schemas/date_from'
                date_to:
                  $ref: '#/components/schemas/date_to'
                profile_id:
                  $ref: '#/components/schemas/profile_id'
      responses:
        '200':
          description: Hiring insight bands for the company and window.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: Insight bands for the requested company and window.
              example:
                data:
                  totals:
                    open: 124
                    new_in_window: 31
                    functions: 6
                    locations: 4
                  seniority:
                    classified: 28
                    leadership: 5
                    tiers:
                      - key: leadership
                        rank: 5
                        count: 5
                      - key: senior
                        rank: 3
                        count: 12
                  postings:
                    - title: Country Manager
                      country_code: GB
                      posted_at: '2026-02-14'
                  weekly_series:
                    - week_start: '2026-02-09'
                      count: 8
                  breakdown_function:
                    - key: sales
                      count: 11
                    - key: engineering
                      count: 7
                  breakdown_department:
                    - key: go_to_market
                      count: 9
                  breakdown_location:
                    - key: GB
                      count: 14
                  window_days: 90
components:
  schemas:
    domain_search_id:
      type: string
      format: uuid
      description: A unique identifier for the company search operation.
    date_from:
      type: string
      format: date
      example: '2026-01-01'
      description: >-
        Start of the date window (ISO 8601, YYYY-MM-DD). Use together with
        `date_to` to scope results to a specific range; omit both to use the
        default window.
    date_to:
      type: string
      format: date
      example: '2026-03-31'
      description: >-
        End of the date window (ISO 8601, YYYY-MM-DD). Must be on or after
        `date_from`.
    profile_id:
      type: integer
      description: >-
        Optional. An identifier for the user profile (workspace) making the
        request. This is no longer required as the API key already includes your
        workspace information. If provided, it helps in associating the lookup
        with a specific user, allowing for data retrieval and credit tracking. 

         Check out `user details` endpoints under the Profile tab for more information.
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        A unique API token that represents the actions you perform through the
        API and the corresponding permissions and operations. You can create it
        through the [Settings](https://dashboard.pubrio.com/#/settings/)
        section.
      in: header

````