> ## 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. # Busca de Sinais de Expansão > Linhas brutas e paginadas de sinais de expansão — a evidência datada por trás do estágio de cada empresa, com fonte e URL de evidência. ## OpenAPI ````yaml pt-openapi POST /expansions/signals/search openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/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: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /expansions/signals/search: post: tags: - Expansion summary: Busca de sinais de expansão description: >- Linhas brutas e paginadas de sinais de expansão — a evidência datada por trás do estágio de cada empresa, com fonte e URL de evidência. operationId: expansions_signals_search requestBody: required: false content: application/json: schema: type: object properties: domain_search_ids: type: array description: Empresas às quais restringir, por `domain_search_id`. items: type: string example: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c is_active: type: boolean description: >- Retorna apenas sinais ativos (`true`) ou apenas retratados (`false`). Omita para ambos. example: true country_codes: type: array description: >- Mercados-alvo aos quais restringir, como códigos ISO 3166-1 alpha-2. items: type: string example: - US - GB signal_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- Tipos de sinal aos quais restringir. Valores desconhecidos não correspondem a nada. signal_subtypes: allOf: - $ref: '#/components/schemas/expansion_signal_subtype_slugs' description: >- Subtipos de sinal aos quais restringir. Valores desconhecidos não correspondem a nada. signal_strengths: allOf: - $ref: '#/components/schemas/signal_strengths' description: >- Intensidades de sinal às quais restringir. Valores desconhecidos não correspondem a nada. source_types: type: array items: type: string description: >- Tipos de fonte aos quais restringir: `jobs`, `ads`, `linkedin`, `news`, `pubrio`. example: - jobs - ads polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging description: >- Direções de sinal a incluir. `expansion` marca entrada e crescimento; os valores `contraction_*` marcam retração. example: - expansion event_dates: $ref: '#/components/schemas/event_dates' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' responses: '200': description: Busca de sinais de expansão content: application/json: schema: type: object properties: metadata: type: object description: Eco dos filtros aplicados a esta requisição. data: type: object description: Contêiner de resultado. properties: pagination: type: object description: >- Página, itens por página, total de entradas e total de páginas. signals: type: array description: >- As linhas de sinal correspondentes, da mais recente para a mais antiga. items: type: object properties: expansion_signal_id: type: integer description: Identificador único desta linha de sinal. domain_search_id: type: string format: uuid description: >- A empresa à qual este sinal pertence. Use-o com [Company Expansion Detail](/pt/api-reference/endpoint/expansions/company_lookup). country_code: type: string description: >- Mercado-alvo em que este sinal foi observado, como código ISO 3166-1 alpha-2. signal_type_slug: type: string description: >- Tipo de sinal. Um dos 17 slugs retornados por [Expansion Reference](/pt/api-reference/endpoint/expansions/types). signal_subtype_slug: type: string nullable: true description: >- Subtipo mais granular, ou `null` quando o tipo não tem subtipo. Cerca de 44% das linhas são `null`. signal_strength_slug: type: string description: >- Intensidade do sinal: `low`, `medium`, `high` ou `very_high`. polarity: type: string description: >- Direção do sinal: `expansion`, ou um dos três valores `contraction_*`. event_date: type: string format: date-time description: >- Quando o evento subjacente aconteceu. Leia em conjunto com `event_date_precision`. event_date_precision: type: string description: >- Quão precisa é `event_date`: `day`, `month`, `quarter`, `year` ou `unknown`. source_type: type: string description: >- De onde o sinal veio. Valores observados: `jobs`, `ads`, `linkedin`, `news`, `pubrio`. source_record_id: type: string nullable: true description: >- Identificador do registro de origem do qual o sinal foi derivado, quando existir. display_label: type: string description: Resumo do sinal, legível e em uma linha. evidence_url: type: string nullable: true description: >- Link para a evidência de suporte. Frequentemente `null` — a maioria das linhas é derivada de fontes estruturadas, não de uma página citável. metadata: type: object description: >- Detalhe específico da fonte. Suas chaves variam conforme `source_type` — linhas de vagas trazem `departments`, `seniority`, `top_titles`, `active_postings`; linhas de anúncios trazem `advertisement_format`, `headline`, `share_pct`. extraction_confidence: type: number nullable: true description: >- Confiança do modelo para sinais extraídos por um modelo; caso contrário, `null`. extraction_model: type: string nullable: true description: Nome do modelo de extração, quando um foi usado. is_active: type: boolean description: >- `true` para sinais ativos, `false` assim que um sinal é retratado. notes: type: string nullable: true description: Anotação em texto livre. Geralmente `null`. created_at: type: string format: date-time description: Quando a linha de sinal foi criada. last_modified: type: string format: date-time description: >- Quando a linha de sinal foi atualizada pela última vez. source_published_at: type: string format: date-time nullable: true description: >- Horário de publicação do documento de origem, quando conhecido. lead_time_days: type: integer nullable: true description: >- Dias entre a publicação da fonte e a data do evento, quando ambas são conhecidas. occurs_at: type: string format: date-time nullable: true description: >- Início da janela que o sinal cobre, para sinais que abrangem um período. occurs_until: type: string format: date-time nullable: true description: >- Fim da janela que o sinal cobre, para sinais que abrangem um período. audit: type: object description: >- Proveniência da linha: `profile_id` e `user_id` são definidos para sinais importados pelo usuário, `import_id` agrupa uma importação em massa, e `is_backfill` marca linhas adicionadas por um backfill histórico. properties: profile_id: type: integer nullable: true user_id: type: string format: uuid nullable: true import_id: type: string nullable: true is_backfill: type: boolean example: metadata: filters: domain_search_ids: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_codes: - US signal_types: - HIRE - AD data: pagination: page: 1 per_page: 25 total_entries: 2990 total_pages: 120 signals: - expansion_signal_id: 580965556 domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US signal_type_slug: HIRE signal_subtype_slug: country_manager signal_strength_slug: very_high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' event_date_precision: day source_type: jobs source_record_id: '4224659596' display_label: Hired Country Manager evidence_url: https://www.linkedin.com/jobs/view/4224659596 metadata: city: Austin country_code: US departments: - sales seniority: - director top_titles: - Country Manager, US active_postings: 3 window_days: 90 extraction_confidence: 0.91 extraction_model: null is_active: true notes: null created_at: '2026-06-20T15:02:11.004Z' last_modified: '2026-06-20T15:02:11.004Z' source_published_at: '2026-06-19T08:00:00.000Z' lead_time_days: 1 occurs_at: null occurs_until: null audit: profile_id: null user_id: null import_id: null is_backfill: false - expansion_signal_id: 580965557 domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US signal_type_slug: AD signal_subtype_slug: null signal_strength_slug: low polarity: expansion event_date: '2026-06-18T08:12:25.866Z' event_date_precision: day source_type: ads source_record_id: 3569a83d-6e96-4bc9-b1a7-abbfa8f4b1ad display_label: >- Full-Stack Observability: 7 Tools Engineers Are Switching To in 2026 evidence_url: null metadata: headline: >- Full-Stack Observability: 7 Tools Engineers Are Switching To in 2026 advertisement_format: Single Image Ad source_type: linkedin share_basis: declared share_pct: null started_at: null ended_at: null extraction_confidence: null extraction_model: null is_active: true notes: null created_at: '2026-06-18T08:12:25.883Z' last_modified: '2026-06-18T08:12:25.883Z' source_published_at: null lead_time_days: null occurs_at: null occurs_until: null audit: profile_id: null user_id: null import_id: null is_backfill: false '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_signal_type_slugs: type: array items: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: - EXEC - HIRE description: >- Filtra para tipos de sinal específicos. Consulte o catálogo de Tipos de Sinal na base de conhecimento para definições e níveis (`DNS` e `INFRA` são sinais de nível Premier). expansion_signal_subtype_slugs: type: array items: type: string enum: - marketing_pullback - domain_dropped - entity_dissolution - exhibiting_booth - speaking_breakout - speaking_keynote - sponsorship - key_departure - country_manager - engineering - freelancer - hiring_freeze - job_posting_removal - legal_compliance - local_employee - operations - regional_vp - remote_sales_bd - supply_chain - ip_abandoned - office_closure - partnership_terminated - product_withdrawal - regulatory_surrender - layoffs - content_decay example: - country_manager - local_employee signal_strengths: type: array items: type: string enum: - low - medium - high - very_high example: - high description: >- Filtra por faixa de confiança da evidência: `low`, `medium` ou `high`. Note que isso é diferente do `signal_strength_slug` por sinal retornado nos registros de sinal (que varia de `low` a `very_high`); qualquer outro valor aqui não corresponde a nada. event_dates: type: array items: type: string example: - '2026-06-01' - '2026-06-30' description: >- Intervalo de datas da data do evento do sinal. O valor máximo é o dia atual. page: type: integer example: 1 default: 1 description: >- Número da página, começando em 1. O teto é o `max_search_page` da sua assinatura (`max_company_search_page` para busca de empresas), retornado por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416**. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o `max_search_per_page` da sua assinatura, retornado por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416** com o código `41676` (ou `41613` na busca de empresas e pessoas), não um conjunto de resultados limitado. responses: general_error: description: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção [Configurações](https://dashboard.pubrio.com/#/settings/). in: header ````