PlatformDocs

Exclude leads

Keep companies, domains, countries, industries, job titles or pages out of your leads, and addresses out of your campaigns.

Authenticated with ?privateKey=YOUR_KEY (see Authentication).

GET/admin/domain-blacklistGet domain blacklist for a website
POST/admin/domain-blacklistCreate domain blacklist entry
DELETE/admin/domain-blacklistDelete domain blacklist
GET/admin/email-blacklistGet blacklisted emails for a website
POST/admin/email-blacklistAdd emails to blacklist
DELETE/admin/email-blacklistRemove emails from blacklist
GET/admin/websites/blacklistGet blacklisted countries
POST/admin/websites/blacklistAdd countries to blacklist
PUT/v3/websites/{websiteId}/page-rulesSet which pages are tracked
POST/v3/exclusions/domainsBlock a company domain
POST/v3/exclusions/peopleBlock a person
GET
Parameters
Website IdID of the website
curl -X GET "https://rest-dash.revealid.xyz/admin/domain-blacklist?privateKey=YOUR_KEY&websiteId=64b7f0a1c2d3e4f5a6b7c8d9"
Response
Press Send request to try it with sample data.

What each field accepts

FieldTypeLimits and formatAccepted values
websiteId*stringpattern ^[0-9a-fA-F]{24}$any

Use case: Keep your customers out of campaigns

POST /admin/email-blacklist with { "websiteId": "…", "csv": "customers", "email": ["jo@acme.example"] } — campaigns on that website never send to those addresses. csv is the group name they are saved under (an empty string for one-off entries).

Use case: Never count your own company or a competitor as a lead

POST /v3/exclusions/domains with { "websiteId": "…", "domain": "acme.example" } blocks one company domain: its visitors are not identified and use no credits. POST /admin/domain-blacklist does the same under a named group (csv). POST /admin/websites/blacklist with { "websiteId": "…", "countryCode": ["DE", "FR"] } blocks whole countries (two-letter codes; the list replaces the saved one).

Use case: Track only your product pages

PUT /v3/websites/{websiteId}/page-rules with { "mode": "include", "rules": [{ "type": "starts-with", "url": "/pricing" }, { "type": "starts-with", "url": "/product" }] } — only visitors of those pages become leads. mode: "exclude" leaves out pages such as /careers instead. Rule types: starts-with, ends-with, contains, does-not-contain.

On this page