Name to Domain

Create Name to Domain task

post/v1/enrichments/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Find company domains from names such as Acme, Inc.. The enrichment returns a domain, validated URL, confidence, and search status when available.

Public ID: company-name-to-domain. Get the current definition. You can read it without authentication.

Settings

Choose dataset_google (default) to search the dataset, then Google if needed. You can also choose dataset or google alone.

Enable countryOverwrite to set data.targetCountry for each company. Use a country name or a two- or three-letter country code. searchCountryCode is the fallback.
Enable acceptNonRoot to accept hosted company pages.
Add unwanted domains to skipDomains.
With the Google workflow, enable onlyProcessCachedResults to use saved results without starting fresh searches.

Settings can change which output fields are returned.

workflowstring

Datablist first uses a company dataset to match names with domains. Datablist might also perform a Google search on the remaining company names.

Allowed values: "dataset_google", "dataset", "google"

searchCountryCodestring

Narrow down the search to a specific country. This setting filters the company dataset and is a country setting for the Google Search fallback.

Allowed values:

"AF", "AL", "DZ", "AS", "AD", "AO", "AQ", "AG", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BT", "BO", "BA", "BW", "BR", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "BQ", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FM", "FJ", "FI", "FR", "PF", "TF", "GA", "GE", "DE", "GH", "GR", "GD", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HU", "IS", "IN", "ID", "IQ", "IE", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MR", "MU", "MX", "MD", "MC", "MN", "ME", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "QA", "CG", "RO", "RU", "RW", "SH", "KN", "LC", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "ES", "LK", "SR", "SZ", "SE", "CH", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "YE", "ZM", "ZW"

countryOverwriteboolean

Enable a targetCountry value for each input. Use a country name or a two- or three-letter country code. Missing or invalid values use searchCountryCode instead.

acceptNonRootboolean

Accept company pages hosted on another website, such as a platform page, instead of requiring the company to own the domain.

Enabled when: workflow==dataset_google,dataset,google,false.

skipDomainsstring

Additional domains to exclude from searches, separated by commas. These are added to the default exclusions.

Enabled when: workflow==dataset_google,google,false.

onlyProcessCachedResultsboolean

If enabled, Datablist will only use your saved Google search results from the cache. It won’t run new live searches. Use this to reduce costs and skip dataset results.

Enabled when: workflow==google.

Additional properties are supported.

Inputs

Give each input an inputId you can use to match the result to your record. Put the fields below in its data object.

companyNamestringrequired

The name of the company to search for (ex: google).

targetCountrystring

Narrow down the search to a specific country. This setting filters the company dataset and is a country setting for the Google Search fallback. If the country is missing or invalid, Datablist will use the global “Target Country” setting as a fallback.

Enabled when: countryOverwrite==true. Required when enabled.

Additional properties are supported.

Credits and limits

Cost: 1 credit per lookup using the dataset, 2.5 credits per lookup for Google search (optional).

Charges depend on the selected workflow and whether cached data or a fresh lookup is used. creditsPerInput: null means variable pricing, not free execution.

Send 1–10,000 inputs per task, within 16 KiB per input and 10 MiB per request. Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days.

You can set maxCredits to stop starting new work after a credit threshold. Work already underway can still exceed it. Enrichment and source tasks share your account balance and task limits. See limits and errors.

Accepted task

The API returns 202 Accepted with a task ID. Save it and check links.self every few seconds. Once the task is completed, failed, or stopped, get Name to Domain task results. The response below is sample data.

Name to Domain overview · Shared task reference

Request

import requests

url = "https://api.datablist.com/v1/enrichments/tasks"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

payload = {
    "enrichmentId": "company-name-to-domain",
    "uniqueId": "company-name-to-domain-example",
    "settings": {
        "workflow": "dataset_google"
    },
    "inputs": [{
        "inputId": "row-1",
        "data": {
            "companyName": "Acme, Inc."
        }
    }]
}

response = requests.post(url, headers=headers, json=payload)

print(response.text)

Response · illustrative example

{
  "@id": "00000000000040008000000000000001",
  "@type": "EnrichmentTask",
  "kind": "enrichment",
  "enrichmentId": "company-name-to-domain",
  "uniqueId": "company-name-to-domain-example",
  "status": "queued",
  "createdAt": "2026-10-09T10:00:00Z",
  "startedAt": null,
  "finishedAt": null,
  "progress": {
    "totalInputs": 1,
    "finishedInputs": 0
  },
  "credits": {
    "used": "0",
    "max": null
  },
  "error": null,
  "links": {
    "self": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001",
    "results": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/results",
    "inputs": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/inputs"
  },
  "outcomes": {
    "success": 0,
    "noResult": 0,
    "error": 0,
    "skipped": 0
  }
}

Authorizations

Settings​

Inputs​

Credits and limits​

Accepted task​

Settings

Inputs

Credits and limits

Accepted task