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

# Expansion Signal Search

> Search the raw expansion signal rows directly, rather than the companies they roll up into. Every signal carries its type, subtype, strength, polarity, dated event, source and evidence URL, so you can audit exactly what drove a company's stage — or build your own scoring on top.

**Scope this call to specific companies.** Pass `domain_search_id_list`. The signal table is very large, and a request filtered only by market or date range does not complete inside the gateway timeout — the connection is dropped after about 60 seconds. Company-scoped calls typically return in well under a second.

For company-level results use [Expansion Search](/en/api-reference/endpoint/expansions/market_lookup); for one company's feed use [Company Signal Events](/en/api-reference/endpoint/expansions/company_pulse_events).



## OpenAPI

````yaml en-openapi POST /expansions/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:
  /expansions/signals/search:
    post:
      tags:
        - Expansion
      summary: Expansion Signal Search
      description: >-
        Search the raw expansion signal rows directly, rather than the companies
        they roll up into. Every signal carries its type, subtype, strength,
        polarity, dated event, source and evidence URL, so you can audit exactly
        what drove a company's stage — or build your own scoring on top.


        **Scope this call to specific companies.** Pass `domain_search_id_list`.
        The signal table is very large, and a request filtered only by market or
        date range does not complete inside the gateway timeout — the connection
        is dropped after about 60 seconds. Company-scoped calls typically return
        in well under a second.


        For company-level results use [Expansion
        Search](/en/api-reference/endpoint/expansions/market_lookup); for one
        company's feed use [Company Signal
        Events](/en/api-reference/endpoint/expansions/company_pulse_events).
      operationId: expansions_signals_search
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                domain_search_id_list:
                  type: array
                  description: >-
                    Restrict to these companies, by `domain_search_id`.
                    **Required in practice** — see the endpoint description: a
                    call not scoped to specific companies is dropped at the
                    gateway timeout.
                  items:
                    type: string
                  example:
                    - 550e8400-e29b-41d4-a716-446655440002
                is_active:
                  type: boolean
                  description: >-
                    Return only live signals (`true`) or only retracted ones
                    (`false`). Omit for both.
                  example: true
                country_code_list:
                  type: array
                  description: >-
                    Restrict to these target markets, as ISO 3166-1 alpha-2
                    codes.
                  items:
                    type: string
                  example:
                    - US
                    - GB
                signal_type_slug_list:
                  type: array
                  description: >-
                    Restrict to these signal types. Resolve valid slugs from
                    [Expansion
                    Reference](/en/api-reference/endpoint/expansions/types).
                  items:
                    type: string
                  example:
                    - HIRE
                    - EXEC
                signal_subtype_slug_list:
                  type: array
                  description: Restrict to these signal subtypes.
                  items:
                    type: string
                  example:
                    - country_manager
                signal_strength_slug_list:
                  type: array
                  description: Restrict to these signal strengths.
                  items:
                    type: string
                  example:
                    - high
                    - very_high
                source_type_list:
                  type: array
                  description: >-
                    Restrict to these source types (for example `linkedin`,
                    `news`, `jobs`).
                  items:
                    type: string
                  example:
                    - linkedin
                    - news
                polarity:
                  type: string
                  description: >-
                    Signal direction. `expansion` marks entry and growth; the
                    three `contraction_*` values mark retreat at different
                    points in the evidence cycle (`contraction_leading` is the
                    earliest indicator, `contraction_confirming` the most
                    settled). There is no bare `contraction` value — sending one
                    silently disables the filter.
                  enum:
                    - expansion
                    - contraction_leading
                    - contraction_lagging
                    - contraction_confirming
                event_date_from:
                  type: string
                  format: date
                  description: >-
                    Earliest event date to include, `YYYY-MM-DD`, interpreted in
                    your workspace timezone.
                  example: '2026-06-01'
                event_date_to:
                  type: string
                  format: date
                  description: >-
                    Latest event date to include, `YYYY-MM-DD`, inclusive of the
                    whole day.
                  example: '2026-06-30'
                page:
                  type: integer
                  example: 1
                  default: 1
                  description: >-
                    Page number, starting at 1. The ceiling is your
                    subscription's `max_search_page` (`max_company_search_page`
                    for company search), returned by
                    [Profile](/en/api-reference/endpoint/profile/profile).
                    Exceeding it returns **HTTP 416**.
                per_page:
                  type: integer
                  description: >-
                    Records per page. Defaults to 25, which is also the ceiling
                    on most plans — the limit is your subscription's
                    `max_search_per_page`, returned by
                    [Profile](/en/api-reference/endpoint/profile/profile).
                    Exceeding it returns **HTTP 416** with code `41676` (or
                    `41613` on company and people search), not a clamped result
                    set.
                  default: 25
                  example: 25
      responses:
        '200':
          description: Expansion Signal Search
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: Echo of the filters applied to this request.
                  data:
                    type: object
                    description: Result container.
                    properties:
                      pagination:
                        type: object
                        description: Page, per-page, total entries and total pages.
                      signals:
                        type: array
                        description: The matching signal rows, newest first.
                        items:
                          type: object
              example:
                metadata:
                  filters:
                    country_code_list:
                      - US
                    signal_type_slug_list:
                      - HIRE
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 134
                    total_pages: 6
                    total_display_pages: 6
                    is_timeout: false
                  signals:
                    - expansion_signal_id: 90211
                      domain_search_id: 550e8400-e29b-41d4-a716-446655440002
                      country_code: US
                      signal_type_slug: HIRE
                      signal_subtype_slug: country_manager
                      signal_strength_slug: high
                      polarity: expansion
                      event_date: '2026-06-20T14:00:00.000Z'
                      event_date_precision: day
                      source_type: linkedin
                      source_record_id: '4224659596'
                      display_label: Hired Country Manager
                      evidence_url: https://linkedin.com/company/example-corp
                      source_published_at: '2026-06-19T08:00:00.000Z'
                      lead_time_days: 1
                      extraction_confidence: 0.91
                      is_active: true
                      created_at: '2026-06-20T15:02:11.004Z'
                      last_modified: '2026-06-20T15:02:11.004Z'
components:
  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

````