Dun & Bradstreet API - DUNS Lookup & Company Intelligence

Look up any company's DUNS number, credit score, risk rating, ownership structure, executive contacts, and more using the D&B Direct API.

---

BEFORE YOU START

This actor has two modes:

Mode	What it does	Cost	Credentials needed?
Demo Mode ON (default)	Returns fake sample data so you can see the output format	Free	No
Demo Mode OFF	Calls the real D&B API and returns real company data	$0.05 per request	Yes — D&B username + password

If you're seeing fake company names like "ACME TECHNOLOGY CORPORATION", you're in Demo Mode. Turn it off and add your D&B credentials to get real data.

To get D&B API credentials: You need a D&B Direct API subscription from Dun & Bradstreet. This is a separate paid service — this actor just connects to their API for you.

---

How to Use (Step by Step)

Step 1: Find a company's DUNS number

Most tasks require a 9-digit DUNS number. If you don't have one, start here:

{
  "task": "search_company",
  "companyName": "Apple",
  "state": "CA",
  "demoMode": false,
  "username": "your-dnb-username",
  "password": "your-dnb-password"
}

Or use match_company for a more precise match (includes confidence scores):

{
  "task": "match_company",
  "companyName": "Apple Inc",
  "city": "Cupertino",
  "state": "CA",
  "countryCode": "US",
  "demoMode": false,
  "username": "your-dnb-username",
  "password": "your-dnb-password"
}

Step 2: Use the DUNS number to get detailed data

Once you have the 9-digit DUNS number, use it with any of these tasks:

Company Profile — address, industry, employees, revenue, executives:

{
  "task": "get_company_profile",
  "dunsNumber": "001234567",
  "demoMode": false,
  "username": "your-dnb-username",
  "password": "your-dnb-password"
}

Credit Score — Paydex score, credit class, payment behavior:

{
  "task": "get_credit_score",
  "dunsNumber": "001234567",
  "demoMode": false,
  "username": "your-dnb-username",
  "password": "your-dnb-password"
}

Risk Rating — failure probability, financial condition, viability:

{
  "task": "get_risk_rating",
  "dunsNumber": "001234567",
  "demoMode": false,
  "username": "your-dnb-username",
  "password": "your-dnb-password"
}

---

All 15 Tasks

Task	What you get	Requires
search_company	Find companies by name/location	Company Name
match_company	Resolve a company to its DUNS number (with confidence score)	Company Name
get_company_profile	Full profile: address, phone, industry, employees, revenue, executives	DUNS Number
get_firmographics	Employee count, annual revenue, NAICS/SIC codes, business type	DUNS Number
get_credit_score	Commercial credit score, Paydex, payment behavior, credit limit	DUNS Number
get_risk_rating	Viability rating, failure/delinquency probability	DUNS Number
get_financial_stress	Financial stress score and bankruptcy probability	DUNS Number
get_payment_info	Payment history, trends, days beyond terms	DUNS Number
get_beneficial_ownership	Who owns the company — ultimate parent, ownership percentages	DUNS Number
get_corporate_linkage	Parent company, subsidiaries, family tree	DUNS Number
get_public_records	Liens, judgments, lawsuits, UCC filings, bankruptcies	DUNS Number
get_contacts	Executive names, titles, departments, emails, phone numbers	DUNS Number
find_competitors	Similar companies with similarity scores	DUNS Number
kyc_compliance	KYC/AML verification — sanctions, PEP, adverse media checks	DUNS Number
batch_match	Look up multiple DUNS numbers at once	Comma-separated DUNS list

---

All Input Fields

Field	Required?	Description
task	Yes	Which operation to run (see table above)
demoMode	No (default: ON)	ON = fake data, OFF = real API calls
username	Only if demoMode is OFF	Your D&B Direct API username
password	Only if demoMode is OFF	Your D&B Direct API password
dunsNumber	For most tasks	9-digit DUNS number (e.g., 001234567)
companyName	For search/match	Business name to search for
countryCode	No (default: US)	2-letter ISO country code
state	No	State/province to narrow search
city	No	City to narrow search
postalCode	No	ZIP/postal code to narrow search
streetAddress	No	Street address for better matching
telephoneNumber	No	Phone number for better matching
naicsCode	No	NAICS industry code filter
sicCode	No	SIC industry code filter
productCode	No (default: DCP_STD)	D&B data tier (STD/ENH/PREM)
matchType	No (default: Advanced)	Basic or Advanced matching
confidenceLowerLimit	No (default: 6)	Min confidence score 1-10
maxCandidates	No (default: 10)	Max results for search/match
dunsNumbers	For batch_match	Comma-separated DUNS numbers
webhookUrl	No	URL to POST results to (Zapier, Make, n8n)

---

Output Format

Every response looks like this:

{
  "task": "get_company_profile",
  "success": true,
  "data": {
    "dunsNumber": "001234567",
    "companyName": "ACME TECHNOLOGY CORPORATION",
    "employeesTotal": 2500,
    "annualSales": 350000000
  },
  "timestamp": "2026-03-24T12:00:00.000Z",
  "demo": true
}

• success: true = it worked, your data is in data
• success: false = something went wrong, check error field
• demo: true = this is fake sample data (you're in Demo Mode)

---

Pricing

$0.05 per API request (flat rate). Demo mode is free.

You also need a D&B Direct API subscription from Dun & Bradstreet (separate cost, not included). This actor just connects to their API — it does not include access to the D&B data itself.

---

Common Mistakes

Problem	Solution
Getting fake "ACME" data	Turn Demo Mode OFF
"username and password required" error	You need D&B API credentials — or turn Demo Mode ON to test
"dunsNumber is required" error	Most tasks need a DUNS number. Use search_company or match_company first to find it
"Invalid DUNS Number" error	Must be exactly 9 digits. Dashes and spaces are OK (they get stripped)
Empty results	The company might not be in D&B's database, or try a different spelling
Authentication failure	Check your D&B credentials. After 3 wrong attempts, D&B locks your account

---

Use Cases

• B2B Sales: Enrich your CRM leads with employee count, revenue, and decision-maker contacts
• Credit Decisions: Check a customer's Paydex score and payment history before extending credit
• Supplier Risk: Evaluate vendor financial stability and bankruptcy probability
• KYC/Compliance: Verify business identity, check sanctions lists, screen for PEPs
• M&A Due Diligence: Map corporate family trees and ownership structures
• Competitor Research: Find similar companies by industry and size

---

Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal