Find topics

GET /v1/intent/topics
GET /v1/intent/topics?type=b2b
GET /v1/intent/topics?type=b2b&industry=Marketing
GET /v1/intent/topics?q=CRM

{
  "data": [
    {
      "topicId": 117805,
      "topicName": "Marketing ROI",
      "type": "b2b",
      "industry": "Marketing",
      "category": "Service"
    }
  ],
  "meta": {
    "total": 20768,
    "page": 1,
    "pageSize": 50,
    "hasMore": true
  }
}

GET /v1/intent/topics/facets

{
  "data": {
    "types": [
      { "value": "b2b", "count": 8766 },
      { "value": "b2c", "count": 6447 },
      { "value": "both", "count": 5555 }
    ],
    "industries": [
      { "value": "Marketing", "count": 829 },
      { "value": "Technology", "count": 1644 }
    ],
    "categories": [
      { "value": "Service", "count": 7234 },
      { "value": "Product", "count": 4521 }
    ],
    "total": 20768
  }
}

GET /v1/intent/topics/search?q=account+based&type=b2b&limit=5

{
  "data": [
    {
      "topicId": 117890,
      "topicName": "Account-Based Marketing",
      "type": "b2b",
      "industry": "Marketing",
      "category": "Service"
    }
  ]
}

POST /v1/intent/topics/lists
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "name": "CRM Topics",
  "topicIds": [117801, 102391],
  "source": "search",
  "keywords": ["crm", "customer data"]
}

GET /v1/intent/topics/lists?limit=50
x-api-key: YOUR_API_KEY

PATCH /v1/intent/topics/lists/{id}
DELETE /v1/intent/topics/lists/{id}

POST /v1/intent/topics/lists/{id}/instantiate
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "name": "CRM Decision Makers",
  "status": "draft",
  "minScore": 70,
  "maxScore": 99,
  "minTopicOverlap": 1,
  "filters": {
    "contact.hasBusinessEmail": true
  }
}

GET /v1/site-topics/recent
x-api-key: YOUR_API_KEY