Find topics

Choose a discovery method

Start with	Endpoint	Reference
A website	`POST /v1/intent/topics/analyze`	Analyze a site
A keyword	`GET /v1/intent/topics/search`	Search topics
Catalog filters	`GET /v1/intent/topics`	Browse topics
Available categories	`GET /v1/intent/topics/facets`	Topic facets

Choose returned topic IDs based on the research behavior you want to target. Reuse those IDs in preview and audience creation requests.

Browse all topics

Use the inventory endpoint to browse the full topic library.

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

Param	Type	Description
`type`	string	`b2b`, `b2c`, or `both`
`industry`	string	Exact industry match
`category`	string	Exact category match
`q`	string	Text search in topic name

The inventory returns the whole matching catalog without pagination. meta.count is the number of matching topics, meta.total is the catalog total, and meta.filters describes the applied filters. Do not send page or pageSize to traverse this endpoint. Industry and category filters use case-insensitive exact matching. q uses a case-insensitive topic-name substring. Catalog results are cached for 24 hours, with stale fallback if refresh fails. See Topic inventory for the response schema. Use facets when you need available filter values with counts.

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
  }
}

Search topics

Use search for autocomplete-style topic lookup.

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"
    }
  ]
}

Save a topic list

Use topic lists when a set of topics should be reused later or turned into an audience.

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"]
}

List saved topic lists:

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

Update or delete a saved list:

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

Create an audience from a topic list

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
  }
}

Authentication and rate limits

Topic inventory, facets, search, and the audience filter catalog are public. Their documented allowance is 2 requests per source IP per 60 seconds without valid authentication, or 200 with a valid organization API key or Bearer token. Site analysis (POST /v1/intent/topics/analyze) has a separate allowance: 2 requests per source IP per 60 seconds without a valid Bearer token, or 30 with one. Do not assume an API key increases the site-analysis allowance. Recent site-analysis history is a Bearer-only dashboard operation. It is not an API-key workflow; save a topic list when your API integration needs to reuse selected topics.

Next steps

Read ICP filters to narrow a topic audience by company and role.
Read Preview audience to validate the config and inspect sample rows.

Start here

Workflow guides

Topic discovery and filters

Topic lists

Audience builder

Visitor overlap and analytics

Audience results

Integrations

Destinations

Deliveries

Choose a discovery method

Browse all topics

Get facet values

Search topics

Save a topic list

Create an audience from a topic list

Authentication and rate limits

Next steps

​Choose a discovery method

​Browse all topics

​Get facet values

​Search topics

​Save a topic list

​Create an audience from a topic list

​Authentication and rate limits

​Next steps

Choose a discovery method

Browse all topics

Get facet values

Search topics

Save a topic list

Create an audience from a topic list

Authentication and rate limits

Next steps