# Dun & Bradstreet — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search millions of companies in Dun & Bradstreet's global business directory to find detailed company profiles and verify D-U-N-S numbers. Look up key business information like company details and identifiers to support due diligence, sales prospecting, and business intelligence needs.

**Category:** Business Directories | **Website:** [dnb.com/](https://dnb.com/) | **Docs:** [parse.bot/marketplace/2815285a-aa42-4903-a126-34736058e249/dnb-com-api](https://parse.bot/marketplace/2815285a-aa42-4903-a126-34736058e249/dnb-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-dnb-com-api-2815285a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_profile

Retrieve a detailed company profile from D&B including financials, contacts, corporate hierarchy, and industry classification. Accepts either a url_selector (from search_companies results) or a full profile URL. Returns structured overview with revenue, employee count, key principal, and the full raw API response for advanced consumers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `profile_url` | string | No | Full D&B profile URL as an alternative to url_selector (e.g. 'https://www.dnb.com/business-directory/company-profiles.alphabet_inc.81d5fd5ef421561d27e09c42d4991805.html') |
| `url_selector` | string | No | URL selector from search_companies results[*].urlSelector (e.g. 'alphabet_inc.81d5fd5ef421561d27e09c42d4991805') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dnb-com-api-2815285a/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_url":"<string>","url_selector":"<string>"}'
```

### lookup_duns_number

Search the D&B directory by company name with optional location filters to find matching companies and their profile links. Useful for verifying business identity and retrieving the url_selector needed for get_company_profile.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City to filter results |
| `company_name` | string | Yes | Company name to search for |
| `country` | string | No | Country ISO alpha-2 code to filter results (e.g. 'us', 'gb', 'de') |
| `state` | string | No | State or region to filter results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dnb-com-api-2815285a/lookup_duns_number \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","company_name":"<string>","country":"<string>","state":"<string>"}'
```

### search_companies

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |
| `page_size` | integer | No | Number of results per page (max 25) |
| `query` | string | Yes | Company name or keyword to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dnb-com-api-2815285a/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>"}'
```