> ## 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.

# Monitor Signals Search

> Read the next page of one paged delivery (`is_paged_delivery: true`). The window is frozen at the run: the page holds only signals of that window, under the monitor's current filters, company scope, exclusions and company dedupe window, in the delivery's order. Each page is one bounded keyset read, and is billed like the equivalent search (one search credit per signal type the page reads; watchlists are free). The page has the webhook payload's shape.



## OpenAPI

````yaml en-openapi POST /monitors/signals/search
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:
  /monitors/signals/search:
    post:
      tags:
        - Monitor
      summary: Search a paged delivery's signals
      description: >-
        Read the next page of one paged delivery (`is_paged_delivery: true`).
        The window is frozen at the run: the page holds only signals of that
        window, under the monitor's current filters, company scope, exclusions
        and company dedupe window, in the delivery's order. Each page is one
        bounded keyset read, and is billed like the equivalent search (one
        search credit per signal type the page reads; watchlists are free). The
        page has the webhook payload's shape.
      operationId: monitors_signals_search
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                page_token:
                  type: string
                  description: >-
                    `metadata.window.next_page_token` from a paged delivery or
                    from the previous page. It carries the frozen window, so the
                    same token always reads the same span; `null` on the last
                    page means the window is done.
              required:
                - page_token
      responses:
        '200':
          description: >-
            The page, in the webhook payload's shape plus the same `pagination`
            block every search returns. The envelope is `{ metadata: {
            monitor_log_id, page_token }, data: {...} }`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      monitor_log_id:
                        type: string
                        format: uuid
                        description: >-
                          The delivery this page belongs to (its Statistic Logs
                          row).
                      page_token:
                        type: string
                        description: The token this page was read with.
                  data:
                    type: object
                    description: >-
                      Same shape as the webhook payload: `monitor`, `metadata`,
                      `triggered_at`, and `signals` (signal record unit) or
                      `companies` (company record unit).
                    properties:
                      metadata:
                        type: object
                        properties:
                          monitor_log_id:
                            type: string
                            format: uuid
                            description: The delivery this page belongs to.
                          total_signals:
                            type: integer
                            description: Signals on this page.
                          total_companies:
                            type: integer
                            description: Companies on this page.
                          window:
                            type: object
                            properties:
                              from:
                                type: string
                                format: date-time
                                description: Start of the window (the previous run).
                              to:
                                type: string
                                format: date-time
                                description: End of the window (this run).
                              next_page_token:
                                type: string
                                nullable: true
                                description: >-
                                  Token for the next page; `null` on the last
                                  page.
                      pagination:
                        $ref: '#/components/schemas/search_pagination'
              example:
                metadata:
                  monitor_log_id: 516b72de-79d5-400b-9bae-423a43eca98b
                  page_token: c2b1…
                data:
                  monitor:
                    monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd
                    name: Weekly CFO hires
                    detection_mode: signal_first
                    record_unit: signal
                  metadata:
                    monitor_log_id: 516b72de-79d5-400b-9bae-423a43eca98b
                    parent_monitor_log_id: null
                    total_signals: 25
                    total_companies: 25
                    total_people: 0
                    window:
                      from: '2026-10-10T02:09:00.000Z'
                      to: '2026-10-17T06:09:56.270Z'
                      next_page_token: eyJhbGciOi…
                  triggered_at: '2026-10-17T06:20:11.002Z'
                  signals: []
                  pagination:
                    page: 2
                    per_page: 25
                    total_entries: 395
                    total_pages: 16
                    total_display_pages: 16
                    is_timeout: false
                    is_estimated: false
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    search_pagination:
      type: object
      description: Pagination for the result set.
      properties:
        page:
          type: integer
          description: Current page number.
        per_page:
          type: integer
          description: Records per page.
        total_entries:
          type: integer
          description: Total matching records. An estimate when `is_estimated` is `true`.
        total_pages:
          type: integer
          description: '`total_entries` divided by `per_page`.'
        total_display_pages:
          type: integer
          description: >-
            Page count for this result, capped by your plan's
            `max_display_search_page`.
        is_estimated:
          type: boolean
          description: >-
            `true` when `total_entries` is an estimate rather than an exact
            count. Do not use an estimated total to decide when to stop paging;
            stop when a page returns fewer rows than `per_page`.
        is_timeout:
          type: boolean
          description: >-
            `true` when the search ran out of time. `total_entries` then only
            counts the rows returned so far, and an empty page means the search
            did not finish, not that nothing matched.
  responses:
    general_error:
      description: >-
        Bad request. The request was malformed or contained invalid parameters.
        Check the error code and message for details.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Rate limit exceeded. Too many requests were made in a given time period.
        Retry after the rate limit window resets.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        Internal server error. An unexpected error occurred on the server.
        Contact support if the error persists.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.