Buyer Intent: Multi-Select Company Size & Revenue Filters

Buyer-intent endpoints now support multi-select firmographic filters. No integration changes required — existing single-value parameters work unchanged.

New: company_size[] and company_revenue[] array filters

POST /v1/buyer-intent/companies and POST /v1/buyer-intent/contacts (and their export variants) now accept arrays of buckets alongside the existing company_size_min / company_revenue_min parameters:

{
  "topic_ids": ["b2b_35642"],
  "company_size": ["51 to 100", "101 to 250"],
  "company_revenue": ["10 Million to 25 Million"]
}

Semantics

• Within a parameter, values are OR'd — company_size: ["51 to 100", "101 to 250"] returns companies in either bucket.
• Across parameters, filters are AND'd — size and revenue arrays together return only companies matching both.
• Legacy precedence: if you send both company_size_min and company_size[], the _min parameter wins and the array is ignored. Same for revenue.
• Per-endpoint bucket vocabularies: the companies endpoint uses finer size buckets ("101 to 250", "251 to 500") while the contacts endpoint uses "101 to 500". Sending a bucket from the wrong vocabulary returns a 400 listing the valid values for that endpoint.
• Invalid or empty arrays return a 400 with the accepted values — never a silent empty result.

The MCP server tools (buyerIntentCompanies, buyerIntentContacts) accept the new arrays as well.

Questions? [email protected]