Create lead list API
Build a targeted domain list from technology and company filters. Runs as a background job; billed 1 credit per delivered row after completion.
Frequently asked questions
How does the async flow work?
How does the async flow work?
list_id and status: "processing". A background job assembles the rows. Poll the list detail endpoint until status is ready, then preview or export it.When am I charged?
When am I charged?
list_size, the maximum the job could deliver. If your balance is lower than list_size, the list is capped to your balance rather than rejected.What does the technology logic field do?
What does the technology logic field do?
or matches domains running any of the listed technologies. and requires all of them. and_not requires the first and excludes the rest — the way to build “running Shopify but not Klaviyo”.How do I get contact data in the list?
How do I get contact data in the list?
has_email: true or has_phone: true to restrict the list to domains where the crawler found contact details. Either way, every export carries the contact columns — emails, phones and five social profile URLs — so you do not have to filter on them to receive them.Can I export a saved audience as a list?
Can I export a saved audience as a list?
segment_id instead of technology filters and the list is built from that audience’s membership, with all the company and contact columns attached.How many lists can I build at once?
How many lists can I build at once?
Authorizations
API key in format tapi_live_[32-char] (live) or tapi_test_[32-char] (test)
Body
The filter set that defines a lead list. Technology filters and company filters combine with AND.
"US SaaS Companies using Cloudflare"
Maximum rows to deliver, and therefore the maximum charge.
1000 <= x <= 10000010000
"company_only"
Only domains where the crawler found an email address.
Only domains where the crawler found a phone number.
ISO-2 codes or English names. Unresolvable values are rejected at create time.
Export a saved audience as a lead list instead of specifying technology filters.
"seg_8f3a2c1b"