Lists

Create a lead list

post/lists

Request

Request body

categoriesstring[]
keywordsstring[]
languagesstring[]
countriesstring[]
industriesstring[]
companySizesinteger[]
tldsstring[]
matchCountryLanguageboolean
matchTechnologies'or' | 'and' | 'not'
subsetinteger
subsetSliceinteger
minAgeinteger

Newest verification calendar month, as a number of months before the current month (UTC).

maxAgeinteger

Oldest verification calendar month, as a number of months before the current month (UTC). The default includes the current month and two previous months.

fromDateinteger
requiredSetsstring[]
excludeNoTrafficboolean
excludeMultilingualboolean
setsstring[]

Result field sets to include in the exported rows. Use signals to add technologySpend and trafficLevel columns.

callbackUrlstring uri
format'json' | 'csv'
baseListIdstring
suppressionListIdstring

A Ready suppression list uploaded by this account, containing domains to exclude. Its domains are fixed once validated. Can be combined with excludeListId to also exclude websites from an existing lead list. Exclusions apply before result limits and credit calculation.

excludeListIdstring
rootPathboolean
subdomains'include' | 'exclude' | 'merge'

Response

Lead list accepted for pricing and generation.

idstring required
status'Calculating' required

Changes

No recorded changes to this operation across all 1 revision of this API.