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 criteria, 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 criteria, 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 criteria, 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 criteria and the theme at this date.

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

trending theme

In this sample, over the filtered period (last 7D), we got ~18.2K documents which match the project criteria. Here "electric pickup" was the most Emerging Theme which saw a 431% jump when compared to previous period. "influential stocks" was among the new themes.

To retrieve this result, we can use trending_top_theme histogram:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/trending_top_theme?access_token=<access_token>&min=1719273600000&max=1719359999000&&top_n=100&tokenizing_mode=noun_phrase'

Theme cloud - API result

In our sample :

  • prev is the percentage of documents in the previous period which match the filter criteria and where the theme was found. Here we got 1.74% of documents with the theme "electric pickup".
  • curr is the percentage of documents in the current period which match the filter criteria and where the theme was found. Here we got 9.26% of documents with the theme "electric pickup".
  • ks is the theme.
  • total_hits: Total number of documents match the filter criteria.
  • In case of "New Themes", the value for prev would be 0.0
  • To calculate "Emerging Themes" or "Decreasing Themes", a calculation is needed using the curr and prev value. To get the percentage increase or decrease, (curr - prev)/prev

Smart Themes​

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

trending theme

In this sample, over the filtered period (last 7D) and source type as Twitter, we got 8097 documents which match the project criteria. "Tesla", "Tesla, Inc", "BMW" etc are amongst the "Brand" themes.

To retrieve this result, we can use smart_theme histogram:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/smart_theme?access_token=<access_token>&q=sourcetype:SOCIALMEDIA_TWITTER  AND published:>1719792000000 AND published :<1720396800000&top_n=25&smart_theme=brands'

Theme cloud - API result

In our sample :

  • v is the number of published documents which match the filter criteria and the theme at this date.
  • ks is the theme.
  • total_hits: Total number of documents match the filter criteria.