Dun & Bradstreet API - DUNS Lookup & Company Intelligence

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

Access D&B Direct+ API for company search, DUNS number lookup, firmographics, credit scores, risk ratings, beneficial ownership, corporate linkage, and business verification. Essential for B2B sales, credit decisions, supplier risk, and KYC compliance.

Features

• Company Search & Match: Find companies and resolve to DUNS numbers
• Firmographics: Employee count, revenue, industry codes, locations
• Credit Scores: Commercial credit scores and payment predictions
• Risk Ratings: Viability ratings, financial stress scores, failure predictors
• Beneficial Ownership: Ultimate parent, ownership chains, UBO data
• Corporate Linkage: Parent/subsidiary relationships, family trees
• Public Records: Liens, judgments, suits, UCC filings, bankruptcies
• KYC Compliance: Know Your Customer and business verification data
• Demo Mode: Test with realistic sample data (no credentials required)

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Task Selection

• task: Operation to perform
  • search_company - Search companies by name/location
  • match_company - Match company to DUNS number
  • get_company_profile - Detailed company profile
  • get_firmographics - Company size, revenue, industry
  • get_credit_score - Commercial credit score
  • get_risk_rating - Viability and risk assessment
  • get_financial_stress - Financial stress score
  • get_payment_info - Payment history and trends
  • get_beneficial_ownership - Ownership structure
  • get_corporate_linkage - Parent/subsidiary tree
  • get_public_records - Liens, judgments, suits
  • get_contacts - Executive contacts
  • find_competitors - Similar companies
  • kyc_compliance - KYC/AML verification
  • batch_match - Batch DUNS matching

Authentication

• username: D&B Direct API username
• password: D&B Direct API password
• demoMode: Run with sample data (no credentials required)

Company Identification

• dunsNumber: 9-digit D-U-N-S number
• companyName: Company name for search
• countryCode: ISO country code (US, GB, DE, etc.)
• state: State or province
• city: City name
• postalCode: ZIP/postal code
• streetAddress: Street address
• telephoneNumber: Phone number
• registrationNumber: Business registration (EIN, etc.)

Industry Filters

• naicsCode: NAICS industry code
• sicCode: SIC industry code

Match Settings

• matchType: Basic or Advanced matching
• confidenceLowerLimit: Minimum confidence (1-10)
• maxCandidates: Max results to return

Product Selection

• productCode: D&B data product
  • DCP_STD - Standard Company Profile
  • DCP_ENH - Enhanced Company Profile
  • DCP_PREM - Premium Company Profile
  • BIR - Business Information Report
  • COMPR - Comprehensive Report
  • CPTR - Compact Report
  • BBR - Business Background Report

Webhook Delivery

• webhookUrl: Send results to Zapier, Make, n8n

Output Format

{
  "data": [...]
}

Pricing

This actor uses pay-per-event billing: Pay only for what you use:

• Company Search: $0.02 per search
• DUNS Match: $0.03 per match
• Company Profile: $0.05 per lookup
• Credit Score: $0.08 per lookup
• Risk Rating: $0.08 per lookup
• Beneficial Ownership: $0.10 per lookup
• KYC Compliance: $0.15 per verification

Note: D&B API access requires a separate subscription with Dun & Bradstreet.

Use Cases

B2B Sales & Marketing

• Enrich CRM leads with firmographic data
• Score accounts by company size and revenue
• Identify decision-makers and contacts
• Find similar companies (competitors/prospects)

Credit & Finance

• Assess creditworthiness before extending terms
• Monitor customer financial health
• Predict payment behavior
• Automate credit decisions

Supplier Risk Management

• Evaluate vendor financial stability
• Monitor supply chain risk
• Due diligence on new suppliers
• Track supplier performance indicators

Compliance & KYC

• Verify business identity
• Beneficial ownership transparency
• Anti-money laundering screening
• Sanctions and watchlist checks

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal