Turn messy company names into clean, readable ones from your AI assistant, no-code workflow or own code.
Pick your tool, copy the line and paste it in. The AI does the setup. You only paste your API key when it asks.
Set up the Datablist Company Name Cleaner API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Company Name Cleaner API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Company Name Cleaner API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Company Name Cleaner API in Make for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Company Name Cleaner API in n8n for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Company Name Cleaner API in Zapier for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Let an AI assistant or your automation tool do the setup, or call the REST API from your own code.
Copy the prompt for Claude, ChatGPT or Cursor, or for Make, n8n or Zapier, and paste it in. The AI creates a Datablist folder on your computer and sets everything up.
When the AI asks, copy your API key from the Datablist app and paste it into the .env file it opened. Never paste it into the chat.
Send your list of company names and get one row back per name: the cleaned name and a confidence level, ready for your emails, sheet or CRM.
See a sample resultUse the HTTP request module or node your tool offers. You need three steps: send the list, wait, then read the results.
POSThttps://api.datablist.com/v1/enrichments/tasksX-API-Key = your API keyContent-Type = application/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"}}
]
}@id from the response. That is your task ID.Add a short wait or delay, then a GET request to https://api.datablist.com/v1/enrichments/tasks/TASK_ID with the same X-API-Key header. Repeat until status is completed.
GET https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50. Map outputs to your columns. If nextCursor is not empty, call again with &cursor= plus that value.
Create a task with one request. The full script with polling and results is in the developer section.
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"}} ] }'
import requests
response = requests.post(
"https://api.datablist.com/v1/enrichments/tasks",
headers={"X-API-Key": "YOUR_PERSONAL_API_KEY"},
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"}}
]
},
)
task = response.json()
print(task["@id"], task["status"])const response = await fetch("https://api.datablist.com/v1/enrichments/tasks", { method: "POST", headers: { "X-API-Key": "YOUR_PERSONAL_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "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"}} ] }), }); const task = await response.json(); console.log(task["@id"], task.status);
Remove legal forms like Inc., LLC or GmbH, fix casing and drop the noise, while keeping the name recognizable. No Datablist workspace, collection or import needed.
Put Company Name Cleaner wherever your data already flows.
Pay per lookup with credits. API access starts on the Growth plan.
Tell us how many company names you need to clean and we'll show you the cheapest way to get it done.
Everything you need to call the REST API directly: code, responses, endpoints, fields, authentication and limits.
DATABLIST_API_KEY and run.A complete script that creates a task, waits for it and prints every result. Replace YOUR_PERSONAL_API_KEY with your key.
# 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'
import time import requests BASE = "https://api.datablist.com/v1/enrichments" HEADERS = {"X-API-Key": "YOUR_PERSONAL_API_KEY"} # 1. Create the task response = requests.post(f"{BASE}/tasks", headers=HEADERS, 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"}} ] }) response.raise_for_status() task_id = response.json()["@id"] # 2. Poll until the task finishes while True: task = requests.get(f"{BASE}/tasks/{task_id}", headers=HEADERS).json() if task["status"] in ("completed", "failed", "stopped"): break time.sleep(5) # 3. Read every result page params = {"limit": 50} while True: page = requests.get(f"{BASE}/tasks/{task_id}/results", headers=HEADERS, params=params).json() for result in page["results"]: print(result["inputId"], result["status"], result["outputs"]) if not page["nextCursor"]: break params["cursor"] = page["nextCursor"]
// Node.js 18+ or any runtime with fetch. Keep your key on the server. const BASE = "https://api.datablist.com/v1/enrichments"; const HEADERS = { "X-API-Key": "YOUR_PERSONAL_API_KEY" }; const sleep = (ms) => new Promise((r) => setTimeout(r, ms)); // 1. Create the task const created = await fetch(`${BASE}/tasks`, { method: "POST", headers: { ...HEADERS, "Content-Type": "application/json" }, body: JSON.stringify({ "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"}} ] }), }); if (!created.ok) throw new Error(`Create failed: ${created.status}`); const taskId = (await created.json())["@id"]; // 2. Poll until the task finishes let task; do { await sleep(5000); task = await (await fetch(`${BASE}/tasks/${taskId}`, { headers: HEADERS })).json(); } while (!["completed", "failed", "stopped"].includes(task.status)); // 3. Read every result page let cursor = null; do { const url = new URL(`${BASE}/tasks/${taskId}/results`); url.searchParams.set("limit", "50"); if (cursor) url.searchParams.set("cursor", cursor); const page = await (await fetch(url, { headers: HEADERS })).json(); for (const result of page.results) { console.log(result.inputId, result.status, result.outputs); } cursor = page.nextCursor; } while (cursor);
One result per input, with your inputId, a status, the outputs and the credits used. Sample data.
{
"taskId": "00000000000040008000000000000001",
"results": [
{
"inputId": "row-1",
"status": "success",
"outputs": {
"cleanedCompanyName": "Brightwave Analytics",
"companyNameConfidence": "High"
},
"creditsUsed": "0.5",
"error": null
}
],
"nextCursor": null
}All paths are relative to https://api.datablist.com. Field definitions come from GET /v1/enrichments/company-name-cleaner (docs updated Oct 21, 2026).
/v1/enrichments/company-name-cleanerRead the schema, no key needed/v1/enrichments/tasksCreate a task/v1/enrichments/tasks/{taskId}Poll status and progress/v1/enrichments/tasks/{taskId}/resultsRead results, 1 to 100 per page/v1/enrichments/tasks/{taskId}/stopCancel a running task/v1/enrichments/tasksTask history, newest firstsettings once per task and one data object per input. Results can include extra fields as the enrichment evolves, so keep unknown keys when you parse outputs.keepLegalSuffixKeep legal forms |
Boolean | Keep legal suffixes such as Inc., Ltd., GmbH or SAS. Defaults to false. |
companyNamerequiredCompany Name |
Text | Company name to clean. |
cleanedCompanyNamerequiredCleaned Company Name |
Text | Cleaned company name. |
companyNameConfidenceConfidence |
Text | AI-estimated confidence that the cleaned name preserves the company identity: High, Medium, Low or Very Low. |
Create a Personal API Key in your Datablist account and send it on every authenticated request.
Send your key in the X-API-Key header. Datablist exchanges and renews access tokens for you.
Learn the newest workflows with detailed step-by-step guides.
Everything you or your AI coding agent need to integrate the Company Name Cleaner API: auth, request, polling, results, limits and retries.
Chain Company Name Cleaner with other enrichments, in your code, in the Datablist app or for free.