Skip to main content
Acompanhe a evolução da Camada de Dados da Pubrio.

​
Lançamentos de 2026

v2.3.2 - Revisão de Referência dos Filtros de Busca (Set 2026)

  • Novo: Enums e Constantes — 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, Busca de Notícias e Busca de Anúncios — 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.
  • 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.
  • 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.
  • 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 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 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.
  • Docs: Autenticação 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 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 e agora estão listados em Limite de taxa.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.

​
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.
  • 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.
  • 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.
  • 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.