Domain leads

Search Domain Leads and return the matching registration records as CSV text for download or downstream processing. Read-only and costs nothing. One machine call returns at most 5,000 rows; use offset to page through larger result sets. Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.export_csv \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "example"
  }'

Over MCP the same operation is the tool domain_leads_export_csv at https://app.chirply.io/api/mcp, same bearer token, same input.

Look up one specific domain and return everything known about who registered it — name, company, phone, email, full postal address, registrar, and registration/expiry dates. Returns null when the domain isn't in the database or was registered behind a privacy proxy. Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.get \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example"
  }'

Over MCP the same operation is the tool domain_leads_get at https://app.chirply.io/api/mcp, same bearer token, same input.

Return the exact number of records currently available in the shared Domain Leads dataset, plus its earliest and latest valid registration dates. Read-only and costs nothing. Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.get_inventory \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool domain_leads_get_inventory at https://app.chirply.io/api/mcp, same bearer token, same input.

Run a domain-leads search and copy the matching registrants into this organization's CRM as contacts, with their name, company, email, phone and website. Creates up to 500 contact records in one call — these are real people's contact details and will appear in the org's contact list, where they can then be called, texted or emailed. Does not send anything by itself and spends no money, but bulk-importing thousands of contacts is tedious to undo, so it asks for confirmation. Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.import_to_contacts \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "example"
  }'

Over MCP the same operation is the tool domain_leads_import_to_contacts at https://app.chirply.io/api/mcp, same bearer token, same input.

List the domain endings (TLDs) and registrant countries available as search filters, each with how many domains carry it, most common first. Use this to discover valid values for the tld and country arguments of domain_leads.search. Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.list_filters \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 1
  }'

Over MCP the same operation is the tool domain_leads_list_filters at https://app.chirply.io/api/mcp, same bearer token, same input.

Given a registrant's email address, list the other domains that same person or business registered. Useful for gauging whether a lead is a real business (a handful of domains) or a domain speculator (hundreds). Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.registrant_portfolio \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com"
  }'

Over MCP the same operation is the tool domain_leads_registrant_portfolio at https://app.chirply.io/api/mcp, same bearer token, same input.

Search the 26,086,322-record historical domain-registration dataset by a keyword in the domain name and return the person or business who registered each one, with their name, company, phone, email and postal address. Registration dates span 1985 through 2024; this is a historical dataset, not live WHOIS. Domains registered behind privacy/proxy services may not carry reachable contact details. Costs nothing to run. Requires the Domain Leads app (a one-time purchase from the App Marketplace) to be installed in this account; without it the call returns 403 app_required and no data.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/domain_leads.search \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "example"
  }'

Over MCP the same operation is the tool domain_leads_search at https://app.chirply.io/api/mcp, same bearer token, same input.