> ## 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. # Insights de Anúncios de Empresas > Insights agregados de sinais publicitários de uma empresa ao longo de uma janela de datas: contagens de anúncios ativos e lançados, mix de canais e posicionamentos, exemplos de criativos, alcance de audiência como distribuição por faixas, e uma série temporal semanal. O alcance é reportado como uma distribuição entre faixas, nunca como um único valor somado. ## OpenAPI ````yaml pt-openapi POST /companies/advertisements/insights 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: /companies/advertisements/insights: post: tags: - Insights summary: Insights de anúncios description: >- Insights agregados de sinais publicitários de uma empresa ao longo de uma janela de datas: contagens de anúncios ativos e lançados, mix de canais e posicionamentos, exemplos de criativos, alcance de audiência como distribuição por faixas, e uma série temporal semanal. O alcance é reportado como uma distribuição entre faixas, nunca como um único valor somado. operationId: companies_advertisements_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' is_include_unlinked_companies: type: boolean example: false description: >- Inclui anúncios ainda não vinculados a um perfil de empresa verificado. responses: '200': description: >- Faixas de insights publicitários para a empresa e a janela informadas. content: application/json: schema: type: object properties: data: type: object description: Faixas de insights para a empresa e a janela solicitadas. properties: postings: type: array description: >- Consolidação do volume de anúncios, agrupada por faixa de alcance, mercados, canal e formato. As chaves são abreviadas para manter o payload pequeno: `r` = slug da faixa de alcance (corresponde a `reach_tiers[].slug`, `null` quando a plataforma não reporta alcance), `m` = os mercados ISO 3166-1 alpha-2 em que os anúncios foram exibidos, `ch` = canal de origem, `fo` = formato do anúncio, `n` = número de anúncios neste grupo. items: type: object reach_tiers: type: array description: >- O catálogo de rótulos das faixas de alcance, ordenado da menor para a maior. Trata-se de uma tabela de referência, não de uma distribuição — não traz contagens. Combine `postings[].r` com `slug` para obter o rótulo legível e leia o volume por faixa em `postings[].n`. O alcance do anúncio é um intervalo de texto na origem, portanto as faixas nunca devem ser somadas em um único valor de alcance. items: type: object creatives: type: array description: >- Criativos recentes de anúncios, priorizando imagem: criativos com imagem real aparecem primeiro, seguidos por anúncios de texto ou vídeo recentes, para que anunciantes sem imagem também apareçam. `headline`, `body` e `cta` podem ser `null`. Tudo o que é necessário para renderizar uma galeria de criativos está aqui — não é preciso uma segunda chamada ao Advertisement Search. items: type: object example: data: totals: total: 14 launched: 4 active: 4 markets: 46 channels: 2 weekly_series: - week_start: '2026-05-25' count: 4 postings: - r: 10k_50k m: - PE - KR - VE - AR ch: facebook fo: video 'n': 1 placement_mix: - key: INSTAGRAM count: 10 creatives: - advertisement_search_id: 29fbc4ec-d9f2-40dc-be00-c96856271f8c image_url: >- https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg headline: null cta: Learn more advertisement_url: https://www.facebook.com/ads/library?id=1234567890 destination_url: https://www.instagram.com/youtube advertiser: YouTube body: this video lives rent free in our minds format: image has_video: false reach_tiers: - slug: lt_1k label: < 1K - slug: 1k_10k label: 1K–10K - slug: 10k_50k label: 10K–50K - slug: 50k_100k label: 50K–100K - slug: 100k_500k label: 100K–500K window_days: 90 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: domain_search_id: type: string format: uuid description: Um identificador único para a operação de busca de empresas. date_from: type: string format: date example: '2026-01-01' description: >- Início da janela de datas (ISO 8601, AAAA-MM-DD). Use junto com `date_to` para restringir os resultados a um intervalo específico; omita ambos para usar a janela padrão. date_to: type: string format: date example: '2026-03-31' description: >- Fim da janela de datas (ISO 8601, AAAA-MM-DD). Deve ser igual ou posterior a `date_from`. 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 ````