Dnb 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.
What is the Dnb 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace dnb-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.d_b_business_directory_api import DnB, Company, CompanyProfile, DunsResult
dnb = DnB()
# Search for companies by keyword
for company in dnb.companies.search(query="Microsoft", page_size=5):
print(company.primary_name, company.city, company.country, company.industry_name)
# Get detailed profile for a specific company
profile = dnb.company("alphabet_inc.81d5fd5ef421561d27e09c42d4991805").profile.get()
print(profile.company_name, profile.revenue, profile.industry, profile.key_principal)
# Look up companies by name with location filter
for result in dnb.dunsresults.lookup(company_name="Apple", country="us"):
print(result.company_name, result.duns_hash, result.city, result.industry)
Full-text search over the D&B Business Directory by company name or keyword. Returns paginated company summaries with address, industry, and location type, plus navigator facets for filtering by country, corporate role, and employee count. Each result carries a urlSelector usable for get_company_profile.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based) |
| queryrequired | string | Company name or keyword to search for |
| page_size | integer | Number of results per page (max 25) |
{
"type": "object",
"fields": {
"companies": "array of company objects with primaryName, companyAddress, companyCity, companyCountry, industryName, locationType, urlSelector, duns hash",
"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": 348
}
],
"numberOfEmployees": [
{
"maximumValue": 5,
"minimumValue": 0,
"candidatesMatchedQuantity": 161
}
],
"familyTreeRolesPlayed": [
{
"familyTreeRolesName": "Branch/Division",
"candidatesMatchedQuantity": 548
}
]
},
"returnResults": 5,
"totalMatchedResults": 1059
},
"status": "success"
}
}About the Dnb API
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.
The Dnb API is a managed, monitored endpoint for dnb.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dnb.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official dnb.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.