dnb.com APIdnb.com ↗
Search D&B's global business directory, retrieve company profiles with financials and contacts, and look up D-U-N-S numbers via a simple REST API.
curl -X GET 'https://api.parse.bot/scraper/74c825f2-e2bf-4077-a4bc-ae1975b468fd/search_companies?page=1&query=Microsoft&page_size=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for companies by name or keyword in the D&B Business Directory. Returns paginated results with company summaries and navigator facets for filtering by country, industry, and employee count.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Company name or keyword to search for |
| page_size | integer | Number of results per page |
{
"type": "object",
"fields": {
"companies": "array of company objects with primaryName, companyAddress, companyCity, companyCountry, industryName, locationType, urlSelector",
"navigators": "object with countries, familyTreeRolesPlayed, and numberOfEmployees facet arrays",
"returnResults": "integer number of results returned in this page",
"totalMatchedResults": "integer total number of matching companies"
},
"sample": {
"data": {
"companies": [
{
"duns": "11cc3fba5624e87df547d444810e77f8",
"companyCity": "Redmond",
"primaryName": "Microsoft Corporation",
"urlSelector": "microsoft_corporation.11cc3fba5624e87df547d444810e77f8",
"industryName": "Software Publishers",
"locationType": "Parent",
"companyRegion": "Washington",
"companyAddress": "1 Microsoft Way",
"companyCountry": "United States",
"companyZipCode": "98052-8300",
"tradeStyleNames": "Microsoft"
}
],
"navigators": {
"countries": [
{
"countryName": "United States",
"countryISOAlpha2Code": "us",
"candidatesMatchedQuantity": 351
}
],
"numberOfEmployees": [
{
"maximumValue": 5,
"minimumValue": 0,
"candidatesMatchedQuantity": 163
}
],
"familyTreeRolesPlayed": [
{
"familyTreeRolesName": "Branch/Division",
"candidatesMatchedQuantity": 551
}
]
},
"returnResults": 5,
"totalMatchedResults": 1065
},
"status": "success"
}
}About the dnb.com API
The D&B Business Directory API exposes 3 endpoints covering company search, full profile retrieval, and D-U-N-S number lookup across millions of businesses in Dun & Bradstreet's global directory. The search_companies endpoint returns paginated results with address, industry, and location type fields alongside navigator facets for filtering by country, employee count, and family tree role. Profile data includes revenue, year started, website, and corporate hierarchy sections.
Endpoints Overview
The API provides three endpoints. search_companies accepts a query string plus optional page and page_size parameters, returning an array of company objects with fields including primaryName, companyAddress, companyCity, companyCountry, industryName, and locationType. It also returns a navigators object with facet arrays for countries, employee count ranges, and family tree roles, plus totalMatchedResults so you can implement pagination correctly.
Company Profiles and D-U-N-S Lookup
get_company_profile accepts either a url_selector from search results (formatted as company_name.hash) or a full profile_url. It returns structured fields — company_name, address, phone, website, revenue, industry, year_started, duns_number — as well as a raw_data object containing the full response payload with overview, contacts, financials, header, and corporate hierarchy sections. Note that phone and year_started may be masked for non-subscribers on the D&B site, which is reflected in what the endpoint can return.
lookup_duns_number is purpose-built for resolving a company_name to its D-U-N-S identifier. It accepts optional city, state, and country (ISO alpha-2 code, e.g. us, gb) filters and returns an array of matching company objects including duns_hash, address, zip_code, industry, location_type, and a profile link, plus a total_results count.
Coverage and Data Shape
All three endpoints draw from Dun & Bradstreet's business directory, which covers companies globally. Revenue figures are denominated in USD. The duns_number field returns an encrypted hash form of the D-U-N-S identifier rather than the raw nine-digit number, consistent with how D&B exposes identifiers in its directory. The raw_data field in profile responses is the place to look for deeper corporate hierarchy and contacts data not surfaced in the top-level fields.
- Resolve a company name to its D-U-N-S hash for cross-referencing business records using
lookup_duns_number - Build a due-diligence workflow that pulls revenue, year started, and industry classification from
get_company_profile - Populate a CRM with verified company addresses and website URLs retrieved from D&B profile data
- Filter company search results by country and employee count range using the
navigatorsfacet arrays fromsearch_companies - Identify corporate hierarchy relationships using the corporate section within the
raw_dataprofile response - Verify whether a prospective partner or vendor has an active D&B listing before initiating onboarding
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Dun & Bradstreet have an official developer API?+
What does `get_company_profile` return for phone numbers and founding year when that data is restricted on the D&B site?+
phone or year_started for non-subscribers, the endpoint returns those fields in the same masked form. The raw_data object is also returned, but restricted fields are not recoverable beyond what the directory exposes publicly.Does the API return the raw nine-digit D-U-N-S number?+
get_company_profile and lookup_duns_number return duns_number and duns_hash as encrypted identifiers, consistent with how D&B surfaces them in the public directory. The unencrypted nine-digit D-U-N-S number is only available through D&B's enterprise API products. You can fork this API on Parse and revise it to add an endpoint that handles any additional identifier formats if D&B exposes them in other directory pages.Can I retrieve credit risk scores or financial ratings through this API?+
How does pagination work in `search_companies`?+
page (page number) and page_size (results per page) as optional parameters. The response includes returnResults indicating how many records are in the current page and totalMatchedResults giving the full count of matching companies, which you can use to calculate total pages and drive pagination loops.