Skip to main content

Introduction

Structure of a topic​

In talkwalker, a topic represents a search query where articles and posts which match the criterias will be indexed. The search filter can be an include query and/or an exclude query. Each query can contain multiple lines, like in the UI. Each line will be considered in the filter with an operator OR. The topics can also be categorized in groups to organize them.

topic_structure.png

note

To index articles and posts indexed within your project, at least one topic (subject to monitor) is mandatory.

Limitations on the topics API​

  • The length of a topic query line cannot exceed 4096 characters (like in the UI).
  • We cannot change the group of an existing topic. To do that, you will need to delete it and recreate it in the new group. In this case, it will have a new topic ID.
  • You cannot rename a topic once created. To do that, you will need to delete it and recreate it with the new name. In this case, it will have a new topic ID.

Custom filters​

Custom filters follow exactly the same structure as the topic, except that they can be applied to filter the results on demand and on multiple topics.

note

It will be the same API calls to manage the custom filters and the topics. Only the parameter type will change:

  • search for a topic.
  • filter for a custom filter.