DealShield public API

Business profiles that agents can actually use.

Resolve a published business without knowing its DealShield slug, then retrieve a stable, structured profile. The API is read-only and never returns private owner contacts or internal source identifiers.

1. Search the directory

Discover published profiles by keyword, city, state, or human-readable industry slug. Results are capped at 25 and use an opaque cursor for stable pagination.

curl 'https://shield.dealport.com/api/v1/profiles/search?q=industrial&state=TX&limit=20'

2. Resolve an exact business

Use a normalized website domain, or an exact name plus city and two-letter state. Results include canonical HTML and JSON URLs and are capped at five.

By domain

curl 'https://shield.dealport.com/api/v1/profiles/resolve?domain=example.com'

By name and location

curl 'https://shield.dealport.com/api/v1/profiles/resolve?name=Example%20Industrial%20Services&city=Tulsa&state=OK'

3. Retrieve the profile

Follow profileApiUrl from a resolution match. A profile includes human-readable business facts, sanitized provenance categories, freshness, messaging state, and stable action links.

curl 'https://shield.dealport.com/api/v1/profiles/example-industrial-tulsa-ok'

Discovery

Agents can begin at /.well-known/dealshield.json or /llms.txt. Search is intentionally paginated rather than offered as a bulk export. Every profile page includes an application/json alternate link, and every API response includes canonical and self links.

Provenance and privacy

provenance reports the public field, observation time, and one of four safe source categories: public_record, company_website, owner_verified, or other_public_source. Database tables, record IDs, owner email addresses, and private contacts are excluded.

Back to DealShield