ICP filters

Get the filter catalog

GET /v1/intent/audiences/filters
x-api-key: YOUR_API_KEY

The response is a catalog, not a flat list of values. Render filters from data.groups[].filters[] and submit each filter by its key. This endpoint is public. An active organization API key can raise the allowance as described in topic authentication and limits. Use each filter’s label, type, supported operators, values, and UI hints to build the control. Submit values[].value, not its display label. Read the returned logic rules and examples for supported combinations. See the generated filter catalog reference for the full schema.

Common filter keys

Use the live catalog as the source of truth. Common current groups include:

Area	Example keys
Company	`company.industries`, `company.industryGroups`, `company.revenueRanges`, `company.names`, `company.domains`
Role	`role.seniority`, `role.departments`, `role.isDecisionMaker`, `role.isCeo`, `role.isVp`, `role.isFinance`
Job titles	`jobTitle.include`, `jobTitle.exclude`, `jobTitle.exact`
Contactability	`contact.hasBusinessEmail`, `contact.hasPersonalEmail`, `contact.hasLinkedin`, `contact.hasAnyPhone`
Geography	`geo.personalStates`, `geo.companyStates`, `geo.personalCities`, `geo.companyCities`
Demographics	`demographics.gender`, `demographics.ageRanges`, `demographics.incomeRanges`, `demographics.netWorth`

Do not submit old flat filter keys such as companyIndustry, companySize, seniority, or hasBusinessEmail.

Multi-select filters

Submit raw values[].value, not the display labels.

{
  "filters": {
    "company.industries": {
      "values": ["software development", "financial services"]
    },
    "role.seniority": {
      "values": ["director", "vp", "c_suite"]
    }
  }
}

Values inside one multi-select are ORed together. Different top-level filters are ANDed together.

Boolean filters

{
  "filters": {
    "contact.hasBusinessEmail": true,
    "role.isDecisionMaker": true
  }
}

Object form is also supported:

{
  "filters": {
    "contact.hasBusinessEmail": {
      "operator": "is_true"
    }
  }
}

Text chip filters

Use text chip filters for free-text job title, company name, domain, NAICS, SIC, city, or ZIP inputs when those keys are present in the catalog.

{
  "filters": {
    "jobTitle.include": {
      "values": ["CFO", "VP Finance", "Head of Revenue"],
      "operator": "contains",
      "mode": "any"
    },
    "jobTitle.exclude": {
      "values": ["assistant", "intern", "student"],
      "operator": "contains",
      "mode": "any"
    }
  }
}

Supported text operators are contains, exact, and starts_with. mode: "any" ORs terms together, and mode: "all" ANDs terms together.

Number range filters

{
  "filters": {
    "company.revenueMin": {
      "min": 1000000,
      "max": 10000000
    }
  }
}

Single-sided range form:

{
  "filters": {
    "company.revenueMin": {
      "operator": "gte",
      "value": 1000000
    }
  }
}

Advanced logic

Prefer simple top-level filters for normal builders. Advanced and and or groups are supported when the user explicitly builds nested logic.

{
  "filters": {
    "and": [
      { "field": "contact.hasBusinessEmail", "value": true },
      {
        "or": [
          { "field": "role.isCfo", "value": true },
          { "field": "role.isVp", "value": true },
          {
            "field": "jobTitle.include",
            "values": ["head of finance"],
            "mode": "any"
          }
        ]
      }
    ]
  }
}

Rules:

A group can contain either and or or at the same level, not both.
Top-level simple filters and top-level groups are combined with AND.
Check the returned catalog rules for restrictions on combining fields, then validate the complete configuration before saving it.

Next steps

Read Preview audience to validate filters before saving an audience.
Read Manage audiences to create or update a saved audience config.

Start here

Workflow guides

Topic discovery and filters

Topic lists

Audience builder

Visitor overlap and analytics

Audience results

Integrations

Destinations

Deliveries

Get the filter catalog

Common filter keys

Multi-select filters

Boolean filters

Text chip filters

Number range filters

Advanced logic

Next steps

​Get the filter catalog

​Common filter keys

​Multi-select filters

​Boolean filters

​Text chip filters

​Number range filters

​Advanced logic

​Next steps

Get the filter catalog

Common filter keys

Multi-select filters

Boolean filters

Text chip filters

Number range filters

Advanced logic

Next steps