Themes
Top themes
This diagram shows the themes which drive your project:
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'
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:
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'
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:
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'
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:
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: 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'
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.