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

# Changelog

> Atualizações recentes e histórico de versões da plataforma Pubrio.

Acompanhe a evolução da Camada de Dados da Pubrio.

## Lançamentos de 2026

<AccordionGroup>
  <Accordion title="v2.3.2 - Revisão de Referência dos Filtros de Busca (Set 2026)" defaultOpen>
    * **Novo:** [Enums e Constantes](/pt/api-reference/enums) — todos os valores fixos que a API aceita ou retorna em uma única página: níveis de senioridade, funções de trabalho, fontes e formatos de anúncios, faixas de alcance, plataformas de publicação, tipos de sinal, níveis de gestão.
    * **Novo:** Guias de busca para [Busca de Vagas](/pt/developer-guides/search/job-search), [Busca de Notícias](/pt/developer-guides/search/news-search) e [Busca de Anúncios](/pt/developer-guides/search/advertisement-search) — tabelas de filtros, explicações de resposta e receitas prontas para copiar e colar.
    * **API:** A Busca de Vagas documenta `functions`, `seniority_ranks`, `launch_dates`, `location_ids`, `created_at` e `is_ascending_order`. As linhas de resposta agora declaram `functions`, `seniority_rank`, `source_type`, `base_salary`, `experience_requirement`, `education_requirement` e `employment_type`.
    * **API:** A Busca de Anúncios documenta `active_dates`, `reach_tiers`, `exclude_source_types`, `created_at`, `advertisement_search_id` e `is_ascending_order`. `source_types` foi corrigido — ele filtra resultados (não apenas o enriquecimento) e aceita `tiktok` e `apple`. As linhas agora declaram `advertisement_format_normalized`, `advertiser`, `advertisement_url`, `is_company_matched` e o trio `total_impressions`; `metadata` documenta `applied_source_types`, `unsupported_source_types`, `coverage_notes` e `skipped_source_types`.
    * **API:** A Busca de Notícias documenta `published_at`, `news_search_id` e `is_ascending_order`, e declara todos os campos de linha, incluindo `expansion_signals` (retornado quando `is_expansion_signal_available` está definido — isso reverte a remoção feita na v2.3.1, que ocorreu antes de essa flag ser lançada).
    * **API:** A Busca de Pessoas documenta `exclude_people_titles`, `exclude_people_locations`, `exclude_departments`, `exclude_department_functions` e `company_exclude_locations`.
    * **API:** A Busca de Empresas documenta `social_media` e `advertisement_status`.
    * **API:** Todos os endpoints de busca agora documentam `metadata.ignored_fields` — chaves de corpo não reconhecidas são descartadas, não rejeitadas, e listadas ali. Busca de Vagas, Notícias e Anúncios também declaram `pagination` e um bloco `metadata` tipado em vez de um objeto de formato livre.
    * **Docs:** Quatro schemas (`job_exclude_locations`, `advertisement_target_locations`, `advertisement_exclude_target_locations` e `domain_search_ids` em Expansion Rankings) tinham uma descrição ao lado de um `$ref`, que o OpenAPI 3.0 descarta silenciosamente. Agora elas são renderizadas.
  </Accordion>

  <Accordion title="v2.3.1 - Revisão de Referência da API de Expansão (Ago 2026)">
    * **API:** **Expansion Signal Search** (`POST /expansions/signals/search`) agora está documentado — consulte as linhas de sinal brutas e datadas por trás do estágio de uma empresa, em vez das empresas para as quais elas se consolidam.
    * **API:** **Expansion Lookup** (`POST /expansions/lookup`) agora está documentado — a versão determinística da Expansion Search, que nunca relaxa automaticamente seus filtros, para dashboards e jobs agendados que precisam de resultados reproduzíveis.
    * **API:** Monitores observando `expansions` agora têm um vocabulário de filtros documentado e um payload de webhook. [Veja Configurando Webhooks](/pt/developer-guides/setting-up-webhooks).
    * **API:** `is_include_metadata` está documentado em Company Expansion Detail, Compare, Summaries e Rankings. O tráfego via chave de API é enxuto por padrão — defina como `true` para receber `confidence_score` e o detalhe completo do modelo.
    * **API:** Códigos de erro de expansão (`40043`, `40360`, `40435`, `40436`) adicionados aos [Códigos de Status](/pt/api-reference/status-codes).
    * **Removido:** As páginas de referência `/companies/{jobs,news,advertisements}/export`. O Export retorna um anexo CSV contra um saldo separado de `data_export_credit` e não retorna nada que o endpoint de Busca correspondente já não retorne como JSON — use Search com paginação em vez disso.
    * **Removido:** A página de referência `/people/enrichment`, que documentava um endpoint que nunca foi lançado. Para enriquecer uma pessoa, chame [People Lookup](/pt/api-reference/endpoint/people/lookup) com `is_enrichment_available: true`.
    * **Docs:** `profile_id` removido de todos os corpos de requisição. Sua chave de API já identifica seu workspace, e o parâmetro era ignorado em requisições via chave de API.
    * **API:** A busca de empresas e pessoas similares agora documenta o identificador de referência que exige. Antes, `/companies/search/similar` retornava `41847 Missing parameter` para todas as combinações de parâmetros documentadas.
    * **API:** [Company Enrichment](/pt/api-reference/endpoint/companies/enrichment) documenta os arrays `jobs`, `news`, `advertisements` e `similar_companies` que retorna junto com o registro da empresa, e avisa que a chamada costuma levar de 30 a 60 segundos.
    * **API:** Oito endpoints agora declaram o `metadata` de nível superior que retornam, incluindo o bloco `profile` com `credit`, `topup_credit` e `total_credit_cost`.
    * **API:** Os endpoints de identificador de empresa documentam os nove identificadores aceitos, adicionando `tiktok_url`, `wantedly_url`, `tw104_url`, `rocketpunch_url`, `remember_url` e `youtrust_url`.
    * **Docs:** `41847 Missing parameter` — o erro mais comum da API — adicionado aos [Códigos de Status](/pt/api-reference/status-codes).
    * **Docs:** [Autenticação](/pt/api-reference/authentication) agora cobre o requisito de `User-Agent`. Clientes com um user agent genérico são bloqueados na borda com `HTTP 403` e `error code: 1010`, o que é facilmente confundido com uma chave de API inválida.
    * **Docs:** [Limite de taxa](/pt/api-reference/rate-limits) documenta os campos de uso e cota retornados pelo Profile Usage, incluindo como `total_max_*` aplica o multiplicador de licença.
    * **API:** Os filtros de expansão (`stages`, `signal_types`, `signal_strengths`, `freshness`, `momentum`, `polarity`) agora listam seus valores permitidos, e cada um avisa que um valor não reconhecido é descartado silenciosamente em vez de rejeitado — descartando o filtro em alguns parâmetros e não retornando nenhuma correspondência em outros.
    * **API:** `momentum` aceita `advancing`, `steady` e `pulling_back`. Os valores de `directions` em Expansion Reference (`retreating`, `new`) são valores de resposta em `stage.direction` e nunca foram válidos como filtro.
    * **API:** News Insights corrigido — `mentions`, `topics`, `sources` e `top_source` são campos inteiros/string dentro de `data.totals`, não arrays de nível superior. `topics` e `sources` são contagens de valores distintos; as listas por item são `category_breakdown` e `market_breakdown`.
    * **API:** Advertisement Insights corrigido — `postings[]` usa as chaves abreviadas `r`, `m`, `ch`, `fo`, `n`; `reach_tiers[]` é um catálogo `{slug, label}` sem contagens; `creatives[]` documenta os dez campos, incluindo `image_url`, `cta` e `has_video`.
    * **API:** As chaves de `parameters` do template de canal variam conforme `channel_type_slug` — templates de e-mail, LinkedIn e Twilio têm cada um um conjunto diferente.
    * **Docs:** Removidos campos de resposta que a API não retorna: `referral_code` de User, `similarity_score` de Similar People, `funding_status` e `crunchbase_url` de LinkedIn Company Lookup, `expansion_signals` de News Search, e `occurs_at` / `occurs_until` de Expansion Signal Search.
    * **Docs:** A tabela de códigos de status foi reconstruída a partir da tabela de erros da API. Nove códigos estavam errados: `40075`, `40076`, `40091`, `40092` e `40095` estavam documentados para falhas de paginação e cota, mas na verdade são `41675`, `41676`, `41691`, `41692` e `41695` em **HTTP 416** — e cada número documentado é um código ativo para algo não relacionado. `40003`, `40602` e `40603` na verdade são `40303`, `40632` e `40633`; `40099` não existe.
    * **Docs:** **HTTP 416** agora está documentado. Estouros de paginação e cota retornam 416 com um código `416xx`, nunca um conjunto de resultados truncado.
    * **Docs:** Adicionada a família de erros de monitor (`40020`–`40035`), incluindo `40021` — `detection_mode` não pode ser alterado após a criação de um monitor.
    * **API:** `per_page` tem limite máximo de `max_search_per_page` do seu plano (25 na maioria dos planos); `26` retorna HTTP 416. `page` tem limite de `max_search_page`. Ambos os limites, e todo outro teto de plano, são retornados por [Profile](/pt/api-reference/endpoint/profile/profile) e agora estão listados em [Limite de taxa](/pt/api-reference/rate-limits).
    * **API:** `people_contact_types` aceita exatamente `email-work`, `email-personal` e `phone`. Um valor não reconhecido **não** é rejeitado — retorna HTTP 200 com `emails: null` e custo zero de crédito, o que é indistinguível de uma pessoa sem dados de contato.
    * **API:** As respostas de resgate retornam `null`, não `[]`, para `emails` e `phones` quando nada é encontrado.
    * **API:** Os parâmetros de `create` de template de canal agora estão documentados — `channel_node_id` é um UUID vindo de Channel Template Types, e determina quais chaves de `parameters` são válidas. `delete` aceita valores numéricos de `channel_template_id` e remove uma versão por vez.
    * **API:** A validação de webhook de monitor executa uma entrega assinada real; uma URL que só responde a `GET` ainda falha, e `details` retorna o corpo da resposta upstream.
  </Accordion>

  <Accordion title="v2.3.0 - O Lançamento da Expansão (Jul 2026)">
    * **Novo Recurso:** **API de Expansão de Mercado.** Acompanhe quais empresas estão entrando em quais mercados, e o quão avançadas elas estão — uma escada de quatro estágios (Explorando → Comprometendo-se → Expandindo → Escalando) construída a partir de sinais reais de contratação, notícias, publicidade, infraestrutura em nuvem e eventos. Busque por corredor com `froms` / `tos`, aprofunde-se na entrada de mercado de uma única empresa, e compare pares. [Comece pelo quickstart](/pt/knowledge-base/concepts/expansion-api-quickstart).
    * **Novo Recurso:** **Busca em linguagem natural.** Envie um `query` em inglês simples para a Expansion Search ("empresas fintech se expandindo para o Reino Unido") e a Pubrio o interpreta em filtros — com explicações opcionais de correspondência por IA, fundamentadas nos sinais reais de cada empresa via `is_explain_match`.
    * **API:** Os resultados agora usam por padrão uma ordem de relevância que prioriza movimentadores corroborados (múltiplos tipos de sinal independentes); envie `sort_by: "recent"` para ordenação puramente por recência.
    * **API:** Monitores agora podem observar **sinais de expansão** (`signal_types: ["expansions"]`) junto com vagas, notícias e anúncios, e um monitor pode ser rascunhado a partir de uma frase em inglês simples via [Monitor Interpret](/pt/api-reference/endpoint/monitors/interpret).
    * **API:** O ciclo de vida do monitor agora é um único campo `status` (`draft` / `active` / `paused` / `inactive`), substituindo os booleanos anteriores `is_active` / `is_paused` em requisições e respostas.
  </Accordion>

  <Accordion title="v2.2.0 - O Lançamento dos Monitores (Abr 2026)">
    * **Novo Recurso:** **Monitores.** Detecção automatizada de sinais com entrega em tempo real — acompanhe vagas de emprego, notícias de empresas e campanhas de anúncios em milhões de empresas sem construir seu próprio pipeline de polling. Defina filtros uma vez, e a Pubrio escaneia, enriquece e entrega os sinais correspondentes ao seu webhook, e-mail ou sequência de abordagem.
    * **Novo Recurso:** **Dois Modos de Detecção.** Escolha entre **Signal First** (varredura ampla de mercado) e **Company First** (acompanhar contas nomeadas) para se adequar ao seu fluxo de prospecção.
    * **Novo Recurso:** **Enriquecimento Automático de Pessoas.** Cada disparo de monitor pode encontrar e resgatar automaticamente contatos nas empresas correspondentes — enriquecimento em múltiplas camadas com filtros configuráveis para nível de gestão, departamento e cargo.
    * **API:** Adicionados 15 novos endpoints de Monitor — CRUD completo, estatísticas, gráficos, logs de detecção, validação de webhook e processamento de teste. [Veja a referência da API de Monitor](/pt/api-reference/endpoint/monitors/create).
    * **API:** `profile_id` não é mais obrigatório nos corpos de requisição. A chave de API agora inclui as informações do workspace. O parâmetro ainda é aceito para compatibilidade retroativa.
    * **API:** Adicionados `operationId`, `summary`, `description` e `tags` a todos os 59 endpoints da API, para melhor compatibilidade com agentes de IA e ferramentas MCP.
    * **Docs:** Habilitado `llms.txt` para descoberta por crawlers de IA.
  </Accordion>

  <Accordion title="v2.1.0 - O Beta das Smart Lists (Fev 2026)">
    * **Novo Recurso:** **Smart Lists com IA (Beta).** Os usuários agora podem enviar CSVs e visualizá-los em uma interface de planilha, onde a Pubrio preenche automaticamente as colunas ausentes.
    * **Dados:** Adicionadas 3 milhões de novas entidades verificadas na região DACH (Alemanha, Áustria, Suíça).
    * **API:** Tempos de resposta mais rápidos (latência reduzida em 200ms) para o endpoint `/enrich/company`.
  </Accordion>

  <Accordion title="v2.0.0 - A Atualização de Ano Novo (Jan 2026)">
    * **Novo Recurso:** **Inteligência de Busca de Anúncios.** Agora indexamos centrais de transparência de anúncios e repositórios de busca paga. Você agora pode ver *se* uma empresa está veiculando anúncios, *onde* está investindo, e *quais* palavras-chave está segmentando.
    * **Melhoria:** Detecção aprimorada de "Stack de Tecnologia" para empresas usando software localizado não padrão na América Latina.
  </Accordion>
</AccordionGroup>

***

## Arquivo 2025: O Ano dos Parceiros

2025 foi definido por nossas principais integrações de ecossistema, levando os dados da Pubrio até as plataformas que você usa todos os dias.

<AccordionGroup>
  <Accordion title="Q4 2025 - As Integrações de Automação">
    * **Integração:** **Ottokit.** Lançado o conector nativo para fluxos de trabalho de agentes autônomos.
    * **Integração:** **Databar.** Adicionada a Pubrio como provedor verificado no marketplace da Databar para pesquisa no-code.
  </Accordion>

  <Accordion title="Q3 2025 - A Sincronização de Design para Sequência">
    * **Integração:** **Stripo.** Habilitada a funcionalidade "Enviar para Sequência", permitindo que equipes de design sincronizem templates HTML diretamente com os fluxos de trabalho da Pubrio.
    * **Recurso:** **Injeção de Variável Dinâmica.** Permitiu que placeholders genéricos em templates fossem resolvidos com dados da Pubrio em tempo real no momento do envio.
  </Accordion>

  <Accordion title="Q2 2025 - A Parceria com a Clay">
    * **Integração:** **Integração Nativa com Clay.** Tornou-se um provedor padrão no menu de enriquecimento da Clay.
    * **Dados:** Expandida a cobertura dos "70% Invisíveis" para incluir 15 novos registros locais na Ásia-Pacífico.
  </Accordion>
</AccordionGroup>
