Go back
GTM Verbs

GTM Verbs

v1 · 24 endpoints

GTM Verbs (24)

API Explorer

— credits
ColdIQ
APIs→GTM Verbs
Ctrl + K
Switch provider
Ctrl + P
Switch endpoint
POSThttps://api.coldiq.com/v1/email/find

Find a person's professional email from name + company/domain, or a LinkedIn URL. Runs a managed provider waterfall by d…

Authentication

No API key — create one in the dashboard

Body

JSON Editor

Single input — synchronous.

ITEM 1

Bulk inputs — run in parallel.

Provider routing. "auto" (default) runs a managed waterfall; a single slug (e.g. "prospeo") pins one vendor; an array (e.g. ["prospeo","wiza"]) is your ordered fallback chain.

Per-record spend cap. A provider that would answer but costs more than this is skipped, so you never pay more than N credits for one record (a miss if nothing answers in budget). Useful to keep a single pricey provider from dominating a large fan-out.

On a miss with a linkedin_url: enrich the person to resolve their CURRENT employer's domain and retry the waterfall once with it — recovers stale/acquired input domains (extra ~1 credit for the enrich hop, disclosed in `_meta.employer_resolution`). Default false.

import requests

url = "https://api.coldiq.com/v1/email/find"

headers = {
    "Authorization": "Bearer ",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())