Skip to main content

Themes

Top themes​

This diagram shows the themes which drive your project:

Theme cloud

In this sample, over the filtered period (between the 1st of October and the 8th of october), we got 3988 documents which match the project criterias, and 48,5% of these documents contain the theme "cars".

To retrieve this result, we can use theme_cloud histogram:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/theme_cloud?access_token=<access_token>q=published:>1633039200000 AND published:<1633644000000'

Theme cloud - API result

In our sample :

  • v is the percentage of documents that match the filter criteria and where the theme was found. Here we got 48,4% of documents with the theme "cars".
  • ks is the theme.
  • total_hits: Total number of documents match the filter criteria.

Top hashtags​

This diagram shows the hashtags which drive your project:

hashtags cloud

In this sample, over the filtered period (between the 1st of October and the 8th of october), we got 3987 documents which match the project criterias, and 126 of these documents contain the hashtag "#Morocco".

To retrieve this result, we can use hashtag histogram:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/hashtag?access_token=<access_token>&q=published:>1633039200000 AND published:<1633644000000'

hashtags cloud - API result

In our sample :

  • v is the number of documents that match the filter criteria and where the hashtag was found. Here we got 126 documents with the hashtag "#Morocco".
  • ks is the hashtag.
  • total_hits: Total number of documents match the filter criteria.

Top emoji​

This diagram shows the emoji which drive your project:

emoji cloud

In this sample, over the filtered period (between the 1st of October and the 8th of october), we got 3987 documents which match the project criterias, and 11 of these documents contain the "thinking face" emoji.

To retrieve this result, we can use emoji histogram:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/emoji?access_token=<access_token>&q=published:>1633039200000 AND published:<1633644000000'

emoji cloud - API result

In our sample :

  • v is the number of documents that match the filter criteria and where the emoji was found. Here we got 11 documents with the "thinking face" emoji.
  • ks is the emoji.
  • total_hits: Total number of documents match the filter criteria.

Themes over time​

This diagram shows the number total of documents which match your query and a theme on a specific date/time:

themes over time

tip

It works also for hashtags and emoji.

In this sample, the 2nd of October, 20h (Europe/Luxembourg time zone), we have 54 documents which were published with the theme "electric".

Warning

WARNING: By API, it’s not possible to get it in one call. You need to make a call for each theme.

To retrieve this result, we can use the published histogram with the parameter q setted to the theme you want to retrieve:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/published?access_token=<access_token>&min=1633039200000&max=1633644000000&interval=hour&q=electric&timezone=Europe/Luxembourg'

themes over time - API result

With:

  • t is the timestamp (here 1633197600000 represents October 2, 2021 8:00:00 PM GMT+02:00).
  • v is the number of published documents which match the filter criterias and the theme at this date.