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 out 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:
  • id
  • date
  • reach
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:
  • asc 
  • desc
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. 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. 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:
  • twitter
  • facebook
  • instagram
  • youtube
  • reddit
  • news-blogs
  • web
 
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 languages 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.  
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=tw,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": 1,
        "date": 1564662952000,
        "reach": 2425,
        "sentiment": "positive",
        "language": "en",
        "location": {
          "latitude": 51.5073219,
          "longitude": -0.1276474,
          "country": "GB",
          "city": "London",
          "place": "London, United Kingdom"
        },
        "done": false,
        "starred": false,
        "url": "https://twitter.com/lawrencebroadie/status/1035052163838431232"
        "source": "twitter",
        "snippet": "... isn't awario able to show the mentions for awario.com and be able to create something world-class experience, multi sports (anyone?!) etc.",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "awario",
                "start_index": 10,
                "end_index": 15
              },

              {
                "text": "awario.com",
                "start_index": 47,
                "end_index": 56
              }
            ],

            "urls": [
              {
                "text": "awario.com",
                "url": "https://awario.com/",
                "start_index": 47,
                "end_index": 56
              }
            ]
          }
        },

        "author": {
          "name": "Lawrence Broadie",
          "username": "lawrencebroadie",
          "avatar": "https://pbs.twimg.com/profile_images/1033799692516241410/95PlLguk_400x400.jpg",
          "audience": 2400,
          "description": "Marcomms leader. @ElectrifyPR/@BigHearts. Even the longest paths lead into sunlight when paved with love. http://medium.com/@lawrencebroadie",
          "website": "http://www.electrify.me.uk",
          "location": {
            "latitude": 51.5073219,
            "longitude": -0.1276474,
            "country": "GB",
            "city": "London",
            "place": "London, United Kingdom"
          },

          "url": "https://twitter.com/lawrencebroadie",
          "entities": {
            "name": {
              "highlighted_text": [
                {
                  "text": "Broadie",
                  "start_index": 9,
                  "end_index": 15
                }
              ]
            },

            "username": {
              "highlighted_text": [
                {
                  "text": "lawrencebroadie",
                  "start_index": 0,
                  "end_index": 14
                }
              ]
            }
          }
        }
      },

      {
        "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 Twitter 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 Twitter chats",
                "start_index": 25,
                "end_index": 67
              }
            ],

            "urls": [
              {
                "text": "list of best digital marketing Twitter chats",
                "url": "https://awario.com/blog/digital-marketing-twitter-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"
  } 
}