# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/dun-and-bradstreet/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/dun-and-bradstreet/get-company-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/dun-and-bradstreet/lookup-duns-number \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/dun-and-bradstreet/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.