Trove

Trove

Headline · Programação · Aprendizado · Negócios

O Trove é uma API gratuita de enriquecimento de transações da Headline. Transforma os dados de transações bancárias em bruto em nomes de estabelecimentos, categorias de gasto e dados de localização.

Prévia da interface de Trove

Sobre Trove

What Is Trove

O Trove é uma API que lê descrições de transações bancárias e de cartão de crédito e devolve o estabelecimento por trás delas. Você envia uma string como "UBER TRIP 8005928996 CA" e recebe de volta o nome da empresa, o domínio, a data de fundação, o setor, as categorias de atuação, a faixa de funcionários, a sede e os perfis sociais oficiais.

O problema que ele resolve é conhecido de quem constrói ferramentas financeiras. As faturas chegam com strings crípticas cheias de números de referência e códigos de localização, e nada disso diz ao usuário onde o dinheiro foi gasto. O Trove troca esse ruído por dados de estabelecimento estruturados que um app pode exibir, agrupar ou analisar. Muitos times recorrem a uma API de dados de estabelecimentos para isso, e a Headline treinou um modelo de linguagem direto sobre texto de transações financeiras em vez de reaproveitar um de propósito geral.

O limite principal é o alcance. O serviço é ajustado para transações dos Estados Unidos escritas em inglês, e a empresa avisa que em outros idiomas e regiões as correspondências podem ser menos precisas. As solicitações em lote também limitam quanto trabalho você consegue enfileirar de uma vez.

Getting Started

  1. Crie uma conta no site do Trove e gere uma chave de API pessoal.
  2. Inclua a chave no cabeçalho X-API-KEY em cada solicitação.
  3. Envie uma transação por POST para https://trove.headline.com/api/v1/transactions/enrich com os campos description, amount, date e user_id.
  4. Leia a resposta JSON do estabelecimento identificado, ou envie lotes pelo endpoint em massa e consulte os resultados.

Informações do produto

Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Trove.

Plano gratuitoSim
Planos pagosFree
PlataformaWeb API (REST)
DesenvolvedorHeadline
CategoriaProgramação · Aprendizado · Negócios
Data de lançamentoJan 2026
Última atualizaçãoJan 2026
Visitas ao siteN/A
Ranking global do siteN/A
Disponibilidade da APISim

Ideal para

Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.

Usuários

  • Desenvolvedores de apps de finanças pessoais
  • Times de fintech que criam painéis de gasto
  • Engenheiros de dados que limpam registros de transações

Tarefas

  • Limpar nomes de estabelecimentos nas faturas
  • Agrupar o gasto por categoria
  • Preencher lacunas nos registros de transações

Cenários

  • Criar um recurso de orçamento
  • Investigar para onde foi um pagamento
  • Corrigir uma correspondência errada

Principais recursos

Enriquecimento de estabelecimentos em tempo real

O endpoint principal recebe a descrição de uma transação, o valor, a data e um identificador de usuário, e devolve o estabelecimento com seu perfil em uma única chamada. A Headline treinou um modelo de linguagem sobre texto financeiro justamente para essa tarefa de análise, então ele lida com os asteriscos e códigos de referência que quebram as regras de correspondência mais simples.

Perfil do estabelecimento com muitos campos

Cada resposta bem-sucedida traz um perfil da empresa: nome, domínio, tipo como Public Company ou Privately Held, setor, categorias de atuação, tamanho aproximado e cidade, estado e país da sede. Também devolve as URLs oficiais de Facebook, X e LinkedIn, o que poupa uma segunda etapa de busca.

Endpoint de enriquecimento em massa

A rota em massa aceita um array de transações e devolve um ID de solicitação que você consulta para obter os resultados. Você pode manter três solicitações em lote em andamento ao mesmo tempo e enviar mais conforme elas terminam, o que combina com rotinas noturnas que processam grandes conjuntos de cartões em blocos.

Ciclo de feedback

Um endpoint de feedback permite devolver um domínio corrigido para qualquer descrição que você enriqueceu. Assim você fecha o ciclo das correspondências erradas e, com o tempo, melhora os resultados para as strings exatas que seu app mais vê.

Modelo de linguagem feito para texto de transações

Em vez de passar as strings financeiras por um modelo geral, a Headline ajustou o próprio com dados de transações. O efeito prático é um tratamento melhor de nomes de estabelecimento abreviados, números de loja embutidos e sufixos de localização comuns nos processadores de cartão.

Prós e contras

Prós

  • Sem custo para começar: o serviço é oferecido de graça, com uma chave de API criada em poucos cliques.
  • Devolve um perfil completo do estabelecimento, não só um nome limpo, com domínio, categorias e sede.
  • O endpoint em massa lida com grandes volumes e informa o progresso por um ID de solicitação.
  • O endpoint de feedback dá uma forma de corrigir e melhorar as correspondências dos seus próprios dados.

Contras

  • É ajustado para transações dos Estados Unidos em inglês, então a precisão cai em outros idiomas e regiões.
  • As solicitações em lote ficam limitadas a três envios simultâneos, o que atrasa trabalhos muito grandes.
  • Exige uma conta e uma chave de API, então não há teste anônimo do endpoint.

Perguntas frequentes

O Trove pega a descrição em bruto de uma transação bancária ou de cartão e devolve o estabelecimento por trás dela. A resposta inclui o nome da empresa, o domínio, o setor, as categorias, a faixa de tamanho, a sede e os perfis sociais.