API de limpeza de nomes de empresas
Transforme nomes de empresas desorganizados em nomes limpos e legíveis a partir do seu assistente de AI, workflow no-code ou código próprio.
- A partir de $0.00034 por nome limpo
- Remove formas jurídicas
- 10.000 nomes limpos por tarefa
| Nome da empresa |
|---|
| BRIGHTWAVE ANALYTICS, INC. |
| northpeak logistics llc |
| Juniper & Vale Studio GmbH |
Utilizado por mais de 38.000 utilizadores em startups e equipas da Fortune 500
Funciona com qualquer ferramenta capaz de enviar pedidos HTTP
Claude
Cursor
Codex
Make
n8n
Zapier
- O seu próprio código
Escolha como começar
Deixe um assistente de AI ou a sua ferramenta de automação fazer a configuração, ou chame a API REST a partir do seu próprio código.
Cole o prompt de configuração
Copie o prompt para Claude Code, Codex ou Cursor, ou para Make, n8n ou Zapier, e cole-o. A AI cria uma pasta Datablist no seu computador e configura tudo.
Cole a sua chave de API
Quando a AI solicitar, copie a sua chave de API da app Datablist e cole-a no ficheiro .env que foi aberto. Nunca a cole no chat.
Obtenha os seus resultados
Envie a sua lista de nomes de empresas e receba uma linha por nome: o nome limpo e um nível de confiança, prontos para os seus emails, folha de cálculo ou CRM.
Ver um exemplo de resultadoUtiliza Make, n8n ou Zapier? Aqui estão todos os campos do pedido HTTP
Utilize o módulo ou node de pedido HTTP disponibilizado pela sua ferramenta. São necessários três passos: enviar a lista, aguardar e depois ler os resultados.
1. Envie a sua lista (pedido HTTP)
- Método
POST- URL
https://api.datablist.com/v1/enrichments/tasks- Headers
X-API-Key= a sua chave de APIContent-Type=application/json- Corpo (JSON)
- json{"enrichmentId": "company-name-cleaner","uniqueId": "company-name-cleaner-import-1","settings": {"keepLegalSuffix": false},"inputs": [{"inputId": "row-1", "data": {"companyName": "BRIGHTWAVE ANALYTICS, INC."}},{"inputId": "row-2", "data": {"companyName": "northpeak logistics llc"}},{"inputId": "row-3", "data": {"companyName": "Juniper & Vale Studio GmbH"}}]}
- Guardar
- O
@idda resposta. Esse é o ID da sua tarefa.
2. Aguarde até estar concluída
Adicione uma breve espera ou atraso e, em seguida, um pedido GET para https://api.datablist.com/v1/enrichments/tasks/TASK_ID com o mesmo header X-API-Key. Repita até status ser completed.
3. Leia os resultados
GET https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50. Associe outputs às suas colunas. Se nextCursor não estiver vazio, faça uma nova chamada com &cursor= seguido desse valor.
Resumo
Remova formas jurídicas como Inc., LLC ou GmbH, corrija maiúsculas e minúsculas e elimine elementos desnecessários, mantendo o nome reconhecível. Não é necessário criar um workspace, uma collection ou uma importação na Datablist.
O que fornece
- Nomes de empresas: um por linha, diretamente da sua lista, folha de cálculo ou CRM
- Manter formas jurídicas (opcional): mantenha Inc., Ltd., GmbH ou SAS quando necessário
O que recebe
- O nome limpo: por exemplo, Brightwave Analytics em vez de BRIGHTWAVE ANALYTICS, INC.
- Um nível de confiança: Alto, Médio, Baixo ou Muito baixo, para saber o que deve verificar
Quanto custa
- 0.5 créditos por nome: por cada nome que enviar para limpeza
- 1.000 créditos = $1: partilhados com a app Datablist
O que as equipas criam com esta API
Integre o Company Name Cleaner onde os seus dados já circulam.
Personalize cold emails
- Nome da empresa da sua lista
- Pronto para o seu email
Escreva "Olá, equipa da Brightwave" em vez de "BRIGHTWAVE ANALYTICS, INC." em cada primeira linha e assunto.
Associe e elimine contas duplicadas
- Nova conta no CRM
- Associada a registos existentes
Limpe os nomes antes de os comparar, para que Acme Inc. e ACME INC correspondam à mesma conta no HubSpot, Salesforce ou Pipedrive.
Prepare nomes para pesquisas
- Nome de empresa em bruto
- Domínio, LinkedIn, emails
Limpe primeiro os nomes e depois envie-os para o Company Name to Domain ou para um email finder, obtendo melhores correspondências.
Quanto vai custar?
Pague por pesquisa com créditos. O acesso à API começa no plano Growth.
Quanto vai custar?
Indique quantos nomes de empresas precisa de limpar e mostraremos a opção mais económica.
= 500 créditos à taxa de 0,5 créditos por nome
Como funcionam os créditos
1.000 créditos = $1, portanto cada crédito custa um décimo de cêntimo. A limpeza custa 0.5 créditos por nome. Campos vazios e nomes duplicados podem reduzir a utilização real, e cada resultado devolve creditsUsed para poder acompanhá-la por linha. Os créditos do plano são renovados mensalmente e os não utilizados são repostos. Os créditos adicionais nunca expiram.
Integre no seu código
Tudo o que precisa para chamar diretamente a API REST: código, respostas, endpoints, campos, autenticação e limites.
datablist/company-name-cleaner-api
Exemplos oficiais: cURL, Python com Requests ou HTTPX assíncrono e TypeScript. Coloque a sua chave em DATABLIST_API_KEY e execute.
Copie, cole e execute
Um script completo que cria uma tarefa, aguarda pela sua conclusão e apresenta todos os resultados. Substitua YOUR_PERSONAL_API_KEY pela sua chave.
# 1. Create the task (returns 202 Accepted and the task "@id")
curl --request POST 'https://api.datablist.com/v1/enrichments/tasks' \
--header 'X-API-Key: YOUR_PERSONAL_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"enrichmentId": "company-name-cleaner",
"uniqueId": "company-name-cleaner-import-1",
"settings": {
"keepLegalSuffix": false
},
"inputs": [
{"inputId": "row-1", "data": {"companyName": "BRIGHTWAVE ANALYTICS, INC."}},
{"inputId": "row-2", "data": {"companyName": "northpeak logistics llc"}},
{"inputId": "row-3", "data": {"companyName": "Juniper & Vale Studio GmbH"}}
]
}'
# 2. Poll every few seconds until status is completed, failed or stopped
curl 'https://api.datablist.com/v1/enrichments/tasks/TASK_ID' \
--header 'X-API-Key: YOUR_PERSONAL_API_KEY'
# 3. Read the results, then follow nextCursor until it is null
curl 'https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50' \
--header 'X-API-Key: YOUR_PERSONAL_API_KEY'O que a API devolve
Um resultado por input, com o seu inputId, um status, os outputs e os créditos utilizados. Dados de exemplo.
{
"taskId": "00000000000040008000000000000001",
"results": [
{
"inputId": "row-1",
"status": "success",
"outputs": {
"cleanedCompanyName": "Brightwave Analytics",
"companyNameConfidence": "High"
},
"creditsUsed": "0.5",
"error": null
}
],
"nextCursor": null
}Endpoints e campos
Todos os paths são relativos a https://api.datablist.com. As definições dos campos provêm de GET /v1/enrichments/company-name-cleaner (documentação atualizada em 21 de outubro de 2026). Versão do schema: 2026-09-12.
Ver schema da API (JSON) (abre num novo separador)
- /v1/enrichments/company-name-cleaner
- Ler o schema, sem necessidade de chave
- POST
- /v1/enrichments/tasks
- Criar uma tarefa
- /v1/enrichments/tasks/{taskId}
- Consultar o status e o progresso
- /v1/enrichments/tasks/{taskId}/results
- Ler os resultados, de 1 a 100 por página
- POST
- /v1/enrichments/tasks/{taskId}/stop
- Cancelar uma tarefa em execução
- /v1/enrichments/tasks
- Histórico de tarefas, da mais recente para a mais antiga
Referência do schema
Envie settings uma vez por tarefa e um objeto data por input. Os resultados podem incluir campos adicionais à medida que o enrichment evolui; por isso, mantenha as chaves desconhecidas ao processar outputs.
Mostrar todas as configurações, inputs e outputs
Configurações
keepLegalSuffixKeep Legal Forms | Boolean | Keep legal forms such as GmbH, Ltd., Inc., or SAS in the cleaned name instead of removing them. Default to False. |
|---|
Inputs (data)
companyNameobrigatórioCompany Name | Text | Company Name to clean. |
|---|
Outputs
cleanedCompanyNameCleaned Company Name | Text | The company name cleaned and standardized. |
|---|---|---|
companyNameConfidenceCompany Name Confidence | Text | AI-estimated confidence that the cleaned name preserves the company's identity: High, Medium, Low, or Very Low. |
Um header, limites claros
Crie uma chave de API pessoal na sua conta Datablist e envie-a em cada pedido autenticado.
Autenticação
Envie a sua chave no header X-API-Key. A Datablist troca e renova os tokens de acesso por si.
- Header:
X-API-Key: YOUR_PERSONAL_API_KEY - Opcional: faça a gestão dos tokens com
Authorization: Bearera partir dePOST /v1/account/token - Um ou outro: enviar ambos os headers devolve
400 AmbiguousCredentials - Apenas no servidor: mantenha as chaves fora de URLs, código do browser e logs
Limites
- Inputs por tarefa: 1 a 10.000
- Tamanho: 16 KiB por input, 10 MiB por pedido
- Tempo de execução: até 24 horas por tarefa
- Criação de tarefas: 10 pedidos por 60 segundos por conta
- Polling e resultados: 120 pedidos por 60 segundos por operação
- Tarefas ativas: cerca de 20 em simultâneo por conta
- Retenção: as tarefas e os resultados são mantidos durante 90 dias
Perguntas frequentes
Tudo o que você ou o seu agente de programação com AI precisam para integrar a API Company Name Cleaner: autenticação, pedidos, polling, resultados, limites e novas tentativas.


