Skip to main content

​
Validate config

Use validation to check a config and see the normalized version without running a preview query. 
POST /v1/intent/audiences/validate
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "topicIds": [117805, 117890],
  "minScore": 70,
  "maxScore": 99,
  "minTopicOverlap": 1,
  "filters": {
    "role.seniority": {
      "values": ["director", "vp", "c_suite"]
    },
    "contact.hasBusinessEmail": true
  }
}
Validation returns valid, configHash, normalizedConfig, appliedFilters, and the query strategy.

​
Preview audience

Preview returns the total count and sample rows before you save or run an audience. 
POST /v1/intent/audiences/preview
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "topicIds": [117805, 117890],
  "minScore": 70,
  "maxScore": 99,
  "minTopicOverlap": 1,
  "filters": {
    "company.industries": {
      "values": ["software development"]
    },
    "role.seniority": {
      "values": ["director", "vp", "c_suite"]
    },
    "contact.hasBusinessEmail": true
  }
}

​
Response

{
  "data": {
    "configHash": "e37de01af6cc6fec...",
    "dataDate": "2026-05-04",
    "strategy": "serving_table_in",
    "totalCount": 1480,
    "breakdowns": {
      "industries": [
        { "value": "software development", "label": "Software Development", "count": 415 }
      ],
      "seniorities": [
        { "value": "director", "label": "Director", "count": 540 }
      ]
    },
    "sample": [
      {
        "hashedEmail": "50c41e8bb3919b48...",
        "firstName": "christine",
        "lastName": "chen",
        "jobTitle": "senior director product marketing",
        "seniority": "director",
        "company": {
          "name": "salesforce",
          "domain": "salesforce.com",
          "industry": "software development"
        },
        "intent": {
          "score": 87,
          "topicOverlap": 2,
          "matchedTopics": [
            {
              "topicId": 117805,
              "topicName": "Marketing ROI",
              "type": "b2b",
              "industry": "Marketing",
              "category": "Service"
            }
          ]
        }
      }
    ],
    "appliedFilters": ["company.industries", "role.seniority", "contact.hasBusinessEmail"],
    "normalizedConfig": {
      "topicIds": [117805, 117890],
      "minScore": 70,
      "maxScore": 99,
      "minTopicOverlap": 1
    }
  }
}

​
Notes

  • topicIds is required and supports 1 to 250 topics.
  • minScore accepts 0 to 99; values below 50 are normalized to 50.
  • maxScore accepts 50 to 99.
  • minTopicOverlap must be at least 1.
  • Expected preview performance depends on topic breadth and filter complexity.