Get mentions
GET alerts/<id>/mentions returns the list of mentions for a specific alert. The alert ID is used to identify the alert. You can find the ID by calling the GET alerts/list method.
This method works for Mention alerts as well as Leads alerts. In addition to the data you requested, the response will contain information about your plan’s monthly mentions limit.
Resource URL
https://api.awario.com/v1.0/alerts/YOUR_ALERT_ID/mentions
Parameters
Parameter | Description | Default value |
access_token | API key for accessing data through API. | |
sort_by | Sorting the list of mentions. If this parameter is not included in the query, the default value will be applied. Accepted values:
|
date |
sort_order | The order of sorting the list of mentions. If this parameter is not included in the query, the default value will be applied. Accepted values:
|
desc |
date_from | Returns mentions with a date equal to or later than a specified date. The date should be passed in the UTC timestamp in milliseconds. If this parameter is not specified, mentions will be returned for all time. | |
date_to | Returns mentions with a date equal to or earlier than a specified date. The date should be passed in the UTC timestamp in milliseconds. If this parameter is not specified, the data will be returned for all time. | |
since_id | Returns results with an ID greater than (that is, more recent than) the specified ID. If this parameter is not specified, all mentions will be returned. | |
source | Returns mentions from a specified source. Multiple sources can be separated by a comma. If this parameter is not specified, the data will be returned for all sources. Accepted values:
|
|
lang | Returns mentions in a specified language. Multiple languages can be separated by a comma. If this parameter is not specified, the data will be returned for all sources. Languages should be used in the ISO format. For mentions where languages are not specified, the unknown parameter can be applied. | |
country | Returns mentions from the specified country. Multiple countries can be separated by a comma. If this parameter is not specified, the data will be returned from all countries. Countries should be used in the ISO format. For mentions where the country can’t be defined, there’s the unknown value. Instagram and Reddit don’t disclose their users’ locations — for these sources the country is always set to unknown. | |
reach_from | Returns mentions with Reach equal to or greater than a specified value. If this parameter is not specified, the data will be returned with any Reach value. The value should be an integer equal to or greater than zero. | |
reach_to | Returns mentions with Reach equal to or less than a specified value. If this parameter is not specified, the data will be returned with any Reach value. The value should be an integer equal to or greater than zero. | |
tag
|
Returns mentions with the specified tag. Multiple tags can be separated by a comma. This filter works according to the mode specified through the tag_match parameter. |
|
tag_match
|
Mode of filtering by tag:
|
any |
limit | Number of mentions to return (max 100). Using a smaller limit will get faster responses. | 100 |
next | A token that returns the next page of data. The token for the next page is passed in the response of the first page. If not included, this is the last page of data. Paging stops when the next link no longer appears. The token includes the filter and sorting parameters, so to get the next page of data you don’t need to specify other parameters except for next. |
Example request
GET https://api.awario.com/v1.0/alerts/YOUR_ALERT_ID/mentions?access_token=YOUR_API_KEY&sort_by=reach&date_from=1564647440000&source=fb,insta,youtube,reddit,news-blogs,web&lang=en,es&country=us,unknown&limit=7
GET https://api.awario.com/v1.0/alerts/YOUR_ALERT_ID/mentions?access_token=YOUR_API_KEY&next=XXX
Example response
{ "limits": [ { "limit_name": "monthly_mentions", "limit_reached": true, "limit_renewal_date": 1567341352000 } ], "alert_data" { "alert_id": 1, "alert_type": "mentions", "alert_name": "awario", "project_id": 1, "project_name": "Awario", "mentions_count": 50347, "mentions": [ { "id": 5, "date": 1564662952000, "reach": 1256, "sentiment": "negative", "language": "en", "location": { "latitude": 43.1789322, "longitude": -88.1167148, "country": "US", "state": "NY", "zip": "10031", "city": "New York", "street": "141st St", "place": "Hamilton Grange National Memorial, NY" }, "done": true, "starred": true, "url": "https://www.facebook.com/683915815077782/posts/1364976440305046" "source": "facebook", "snippet": "#LastWeekOnSocialMedia", "author": { "name": "Awario", "avatar": "https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/18057845_1004200689715958_6515984672426349372_n.png...", "audience": 1243, "description": "Awario is an app that helps businesses monitor social media buzz, find new mentions, and control all their SMM efforts.", "website": "https://awario.com", "location": { "latitude": 43.1789322, "longitude": -88.1167148, "country": "US", "city": "New York", "place": "New York, United States" }, "url": "https://www.facebook.com/683915815077782", "entities": { "name": { "highlighted_text": [ { "text": "Awario", "start_index": 0, "end_index": 5 } ] } } } }, { "id": 3, "date": 1564662952000, "reach": 743, "language": "en", "done": false, "starred": false, "url": "https://www.instagram.com/p/Bz0fqb0oT4n/" "source": "instagram", "snippet": "#who_makes_awario Instagram is the best place to introduce our team because everyone who works in Awario is so gosh damn beautiful! This is Masha...", "entities": { "snippet": { "highlighted_text": [ { "text": "awario", "start_index": 11, "end_index": 16 } ] } }, "author": { "name": "awarioapp", "avatar": "https://scontent.xx.fbcdn.net/v/t51.2885-15/33638668_401226460393615_3835828853901623296_n.jpg...", "audience": 540, "description": "Monitor mentions of your brand, competitors, or anything else across social and the web #socialmediamarketing #sociallistening", "website": "https://awario.com/", "url": "https://www.instagram.com/awarioapp/" } }, { "id": 2, "date": 1564662952000, "reach": 425, "sentiment": "positive", "language": "en", "done": false, "starred": false, "url": "https://www.youtube.com/watch?v=ompnFW7Is_E" "source": "youtube", "title": "Awario Free copy 100% working link", "thumbnail": "https://i.ytimg.com/vi/ompnFW7Is_E/default.jpg", "snippet": "... copy 100% working link https://tinyurl.com/y2l2pr3p Awario is a social media listening tool that lets you track mentions from social media and the ...", "entities": { "title": { "highlighted_text": [ { "text": "Awario", "start_index": 0, "end_index": 5 } ] }, "snippet": { "highlighted_text": [ { "text": "https://tinyurl.com/y2l2pr3p", "start_index": 27, "end_index": 54 } ], "urls": [ { "text": "https://tinyurl.com/y2l2pr3p", "url": "https://awario.com/pricing/?AFFILIATE=96008&_ga=2.186103457.921218340.1564663179-492807315.1520251648", "start_index": 27, "end_index": 54 } ] } }, "author": { "name": "Takerpomo", "avatar": "https://yt3.ggpht.com/a/AGF-l78SWnMAQO5ETs39TcdIY7P1CN1BdggbpGd8hA=s88-mo-c-c0xffffffff-rj-k-no", "audience": 250, "description": "Takepromo reviews & promos", "url": "https://www.youtube.com/channel/UCIbNFBSXc7M6uJ9smJbsLJg", } }, { "id": 6, "date": 1564662952000, "reach": 245, "language": "en", "done": false, "starred": false, "url": "https://www.reddit.com/r/SandersForPresident/comments/ckq7x0/sanders_is_the_most_mentioned_democratic/" "source": "reddit", "subreddit": "SandersForPresident", "snippet": "... mentioned on social media, news, blogs, and forums with 178K mentions. Source: https://awario.com/blog/democratic-debates-2020-social-media-analysis/", "entities": { "snippet": { "highlighted_text": [ { "text": "awario", "start_index": 91, "end_index": 96 } ] } }, "author": { "name": "iknowhatyouthink", "avatar": "https://www.redditstatic.com/avatars/avatar_default_13_7E53C1.png", "audience": 155, "description": "I'm a good man with interesting thoughts. I love everything new. I'm fond of knowing what surrounds me.", "url": "https://www.reddit.com/user/iknowhatyouthink/", } }, { "id": 4, "date": 1564662952000, "reach": 30, "language": "en", "done": false, "starred": false, "url": "https://medium.com/@julianmoncet/4-effective-social-media-lead-generation-techniques-816d270d609b" "source": "news-blogs", "title": "4 Effective Social Media Lead Generation Techniques", "snippet": "... marketers and a full list of best digital marketing chats exists to make my life easier. With content marketing taking over every niche, you ...", "entities": { "tittle": { "highlighted_text": [ { "text": "Social", "start_index": 12, "end_index": 17 } ] }, "snippet": { "highlighted_text": [ { "text": "list of best digital marketing chats", "start_index": 25, "end_index": 67 } ], "urls": [ { "text": "list of best digital marketing chats", "url": "https://awario.com/blog/digital-marketing-chats/", "start_index": 25, "end_index": 67 } ] } }, "author": { "name": "medium.com", "avatar": "https://www.google.com/s2/favicons?domain=medium.com", "audience": 94, "written_by": "Julian Moncet", "url": "https://medium.com/", } }, { "id": 7, "date": 1564662952000, "reach": 0, "language": "en", "done": false, "starred": false, "url": "https://www.sometag.net/awari" "source": "web", "title": "Explore the #awari hashtag statistics and most popular instagram posts on SomeTag", "snippet": "... (474 posts)- 4.38% awario (464 posts)- 4.29% awaribags (311 posts)- 2.87% awarid (298 posts)- 2.75% awaridcosmetics (185 posts)- 1.71% awarincitybag ...", "entities": { "snippet": { "highlighted_text": [ { "text": "awario", "start_index": 23, "end_index": 28 } ], } }, "author": { "name": "sometag.net", "avatar": "https://www.google.com/s2/favicons?domain=sometag.net", "audience": 0, "url": "https://www.sometag.net/", } }, ], "next": "a8RMaGJNHWemdJkYqKmHy63haw2CxcFCiyun67i7tR14LhO9duKsSERE0jZujBhylpfu7agGTTSSYtYZ34ssFyo4Hib" } }