Skip to main content

Mapping between widget and histogram API

Section in left menu (with comparison)Name of widgetType of HistogramParametersLink to the details and samples
Results (none)Results over timepublishedMin and max for the datesResult over time
Results (Topics)Results over time by TopicspublishedMin and max for the dates
breakdown=topic
Result over time by topics
Results (Media Types)Results over time by Media typespublishedMin and max for the dates
breakdown=sourcetype
Results over time by Media Types
Results (Media Types)Share of Media TypepublishedMin and max for the date
breakdown=sourcetype
interval=<highest>
Share of Media types
Results (Sentiment)Results over time by sentimentspublishedMin and max for the dates
breakdown=sentiment
Results over time by Sentiments
Results (Sentiment)Share of sentimentspublishedMin and max for the date
breakdown=sentiment
interval=<highest>
Share of Sentiments
Results (Countries / regions)Results over time by Countries/regionspublishedMin and max for the dates
breakdown=country
Results over time by countries
Results (Countries / regions)Share of CountriespublishedMin and max for the dates
breakdown=country
interval=<highest>
Share of Countries
Performances (none)Results (or Mentions)publishedMin and max for the dates
interval=<highest>
Results (or mentions)
Performances (none)EngagementEngagementinterval=<highest>Engagement
Performances (none)Engagement over timepublishedMin and max for the dates
value_type=engagement
Engagement over time
Performances (none)Potential reachreachinterval=<highest>Potential reach
Performances (none)Potential reach over timepublishedMin and max for the dates
value_type=reach
Potential reach over time
Performances (none)Engagement splitpublishedMin and max for the dates
value_type=one of:
  • facebook_shares
  • facebook_likes
  • twitter_retweets
  • twitter_shares
  • twitter_likes
  • twitter_followers
  • instagram_likes
  • youtube_views
  • youtube_likes
  • youtube_dislikes
  • comment_count
Engagement split
Performance (for one topic)Reach VS Engagement2 calls needed: engagement reachtopic=<topic_id>
interval=<highest>
Reach VS Engagement
Performances (Topics)Share of TopicspublishedMin and max for the dates
breakdown=topic
interval=<highest>
Share of topics
Performances (Media Types)Share of engagement by Media TypespublishedMin and max for the dates
breakdown=sourcetype
value_type=engagement
interval=<highest>
Share of engagement by Media Types
Performances (Media Types)Engagement over time by Media TypespublishedMin and max for the dates
breakdown=sourcetype
value_type=engagement
Engagement over time by Media types
Performances (Media Types)Share of reach by Media TypespublishedMin and max for the dates
breakdown=sourcetype
value_type=reach
interval=<highest>
Share of reach by Media Types
Performances (Media Types)Reach over time by Media TypespublishedMin and max for the dates
breakdown=sourcetype
value_type=reach
Potential reach over time by Media Types
Performances (Media Types)Results (or Mentions) for a specific Media typepublishedMin and max for the dates
interval=<highest>
q=sourcetype:xxx

List of source types: Source Type options
Performances (Media Types)Engagement for a specific Media typeengagementq=sourcetype:xxx

List of source types: Source Type options
Performances (Media Types)Engagement over time for a specific Media typepublishedMin and max for the dates
q=sourcetype:xxx

List of source types: Source Type options
Performances (Media Types)Potential reach for a specific Media typereachq=sourcetype:xxx

List of source types: Source Type options
Performances (Media Types)Potential reach over time for a specific Media typepublishedin and max for the dates
q=sourcetype:xxx

List of source types: Source Type options
Performances (Sentiment)Share of engagement by SentimentspublishedMin and max for the dates
breakdown=sentiment
value_type=engagement
interval=<highest>
Share of engagement by Sentiments
Performances (Sentiment)Engagement over time by sentimentpublishedMin and max for the dates
value_type=engagement
breakdown=sentiment
Engagement over time by Sentiments
Performances (Sentiment)Share of reach by SentimentspublishedMin and max for the dates
breakdown=sentiment
value_type=reach
interval=<highest>
Share of reach by Sentiments
Performances (Sentiment)Reach over time by SentimentspublishedMin and max for the dates
breakdown=sentiment
value_type=reach
Potential reach over time by Sentiments
Performances (Countries / regions)Share of engagement by CountriespublishedMin and max for the dates
breakdown=country
value_type=engagement
interval=<highest>
Share of engagement by Countries
Performances (Countries / regions)Engagement over time by CountriespublishedMin and max for the dates
value_type=engagement
breakdown=country
Engagement over time by Countries
Performances (Countries / regions)Share of reach by CountriespublishedMin and max for the dates
breakdown=country
value_type=reach
interval=<highest>
Share of reach by Countries
Performances (Countries / regions)Reach over time by CountriespublishedMin and max for the dates
breakdown=country
value_type=reach
Potential reach over time by Countries
InfluencersUnique authorsunique_authorUnique authors
InfluencersAverage mentions per authorsunique_author total_hits / vAverage mentions per authors
InfluencersTop influencerstop_influencersTop influencers
InfluencersTop sitestop_influencersTop sites
Influencers (Media Types)Unique authors by Media typesunique_authorq=sourcetype:xxx

List of source types: Source Type options
Influencers (Sentiments)Unique authors by sentimentsunique_authorq=sentiment: one of
  • positive
  • neutral
  • negative
Influencers (Countries / regions)Unique authors by countriesunique_authorq=sourcecountry:xxx

List of country codes: Country codes
SentimentShare of sentimentspublishedMin and max for the date
breakdown=sentiment
interval=<highest>
Share of sentiments
SentimentNet sentiment (take into account only positive and negative)Published Net sentiment = (#positive posts - #negative posts) / (#positive posts + #negative posts)Min and max for the date
breakdown=sentiment
interval=<highest>
Net Sentiment
SentimentSentiments over timepublishedMin and max for the date
breakdown=sentiment
Sentiment over time
SentimentNet sentiment over timePublished Net sentiment = (#positive posts - #negative posts) / (#positive posts + #negative posts)Min and max for the date
breakdown=sentiment
Net Sentiment over time
SentimentSentiment key driverspublished sentiment/#totalMin and max for the date
breakdown=sentiment
interval=<highest>
q=<theme>
Sentiment key driver
SentimentEmotions over timepublishedMin and max for the date
q=filter: one of
  • emotionfilter-anger
  • emotionfilter-sadness
  • emotionfilter-fear
  • emotionfilter-love
  • emotionfilter-joy
  • emotionfilter-surprise
Emotions over time
SentimentShare of emotionspublishedMin and max for the date
interval=<highest>
q=filter: one of
  • emotionfilter-anger
  • emotionfilter-sadness
  • emotionfilter-fear
  • emotionfilter-love
  • emotionfilter-joy
  • emotionfilter-surprise
Share of emotions
ThemesThemesthemesTop themes
ThemesThemes (layout: hashtags)hashtagTop hashtags
ThemesThemes (layout: emoji)emojiTop emoji
ThemesThemes over timepublishedMin and max for the date
q=<theme>
Themes over time
DemographicGendergenderGender
DemographicAgeageAge
DemographicTop countriescountryTop countries
DemographicTop languageslanguageTop languages
DemographicTop family statuspublishedMin and max for the date
breakdown=sentiment
interval=<highest>
q=demographic:one of:
  • familystatus-parents
  • familystatus-single
  • familystatus-married
  • familystatus-senior
Top family status
DemographicTop interestsinterestTop interests
DemographicTop occupationsoccupationTop occupations
DemographicShare of individual/businesspublishedMin and max for the date
interval=<highest>
q=authorcategory: one of:
  • individual
  • business
Share of individual/business
DemographicShare of automated accountspublishedMin and max for the date
interval=<highest>
q=is:automated_post
Share of automated accounts
World mapTop countriescountryDistribution of the results on the world map
World mapTop Regions (zoom in country)source_regionq=sourcecontry:<country code>

List of country codes: Country codes
Distribution of the results on the world map (zoom on regions)
World mapTop Cities (zoom in region)source_cityq=sourcegeo:<short id>Distribution of the results on the world map (zoom on cities)
Visual insightsIndoor /Outdoor splitpublishedMin and max for the date
interval=<highest>
q=image:one of:
  • scene-outdoor
  • scene-indoor
Indoor / Outdoor split
Visual insightsInput SplitpublishedMin and max for the date
interval=<highest>
q=contains:one of:
  • image
  • video
  • audio
Input split