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:
  • 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 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:
  • 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 location. Multiple countries can be separated by a comma. If this parameter is not specified, the data will be returned from all locations. 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 — returns mentions that have at least one of the specified tags;
  • all — return mentions that have all specified tags.
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=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_reached": false,
      "limit_name": "monthly_mentions"
    }
  ],
  "alert_data": {
    "alert_id": 500037162,
    "alert_type": "mentions",
    "alert_name": "British Airways",
    "project_id": 11260,
    "project_name": "Airways",
    "mentions_count": 12505,
    "mentions": [
      {
        "id": 1121412319,
        "date": 1634569220000,
        "reach": 24046552,
        "language": "en",
        "url": "https://www.youtube.com/watch?v=i5lbl5w6AqI",
        "snippet": "... Our countdown includes British Airways, American Airlines, United Airlines, and more! What do you think was the worst apology given by an airline? ...",
        "title": "Top 10 Worst \"Apologies\" From Airlines",
        "done": false,
        "starred": false,
        "tags": [],
        "author": {
          "name": "WatchMojo.com",
          "avatar": "https://yt3.ggpht.com/ytc/AKedOLQXzhKDjfkdf9IhL8YOZ0pvOkaoDIsBHWtRUtfMig=s88-c-k-c0x00ffffff-no-rj",
          "audience": 24000000,
          "description": "Top 10 lists on Music, TV, Film and Video Games. We publish 4 or more Top 10s daily. Subscribe for new top 10 lists every day, and binge watch on Top 10s covering Pop Culture, Celebrity, Movies, Music, TV, Film, Video Games, Politics, News, Comics and Superheroes. WatchMojo's back catalogue has ten thousand videos on Top 10 lists, Origins, Biographies, Tips, How To's, Reviews, Commentary and more ...",
          "url": "https://www.youtube.com/channel/UCaWd5_7JhbQBe4dknZhsHJg"
        },
        "sentiment": "negative",
        "source": "youtube",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "British",
                "start_index": 27,
                "end_index": 34
              },
              {
                "text": "Airways",
                "start_index": 35,
                "end_index": 42
              }
            ]
          }
        }
      },
      {
        "id": 1016452033,
        "date": 1626359405000,
        "reach": 18788877,
        "language": "en",
        "url": "https://www.youtube.com/watch?v=f0cAp-Rmqi4",
        "snippet": "... 3:43 Virgin Atlantic vs British Airways 5:39 Expanding Virgin empire 6:08 Adventures of Richard Branson 6:56 Philanthropy and awards 7:28 Virgin ...",
        "title": "Richard Branson, वो आदमी जिसने Space Travel में Jeff Bezos का मज़ा खराब कर दिया | Elon Musk",
        "done": false,
        "starred": false,
        "tags": [],
        "author": {
          "name": "The Lallantop",
          "avatar": "https://yt3.ggpht.com/ytc/AKedOLQdbvRep-wWWrEC9AfuLEokw-YYbJL5mzfqNhLjmDs=s88-c-k-c0x00ffffff-no-rj",
          "audience": 18700000,
          "description": "दी लल्लनटॉप यूट्यूब चैनल पर स्वागत है. यहां आपको मिलेगी लेटेस्ट खबर, पॉलिटिकल उठापटक, मनोरंजन की दुनिया, खेल-खिलाड़ी, सोशल मीडिया का वायरल रायता, फिल्म रिव्यू, खास मुद्दों पर माथापच्ची और बहुत कुछ. हिंदी में धड़ाधड़ खबरों, एक्सक्लूसिव वीडियोज़ और सेलिब्रिटीज़ के साथ बातचीत से जुड़े रहने के लिए बने रहो दी लल्लनटॉप के साथ. मम्मी कसम मिलेगा मारक मज़ा. Welcome to The Lallantop YouTube Channel. The Lal...",
          "url": "https://www.youtube.com/channel/UCx8Z14PpntdaxCt2hakbQLQ"
        },
        "sentiment": "positive",
        "source": "youtube",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "British",
                "start_index": 28,
                "end_index": 35
              },
              {
                "text": "Airways",
                "start_index": 36,
                "end_index": 43
              }
            ]
          }
        }
      },
      {
        "id": 1103871922,
        "date": 1632312558000,
        "reach": 7944788,
        "language": "en",
        "url": "https://www.youtube.com/watch?v=3xG5orsRS5M",
        "snippet": "#BritishAirways #London #Islamabad #BA260 BA flight to London makes emergency landing after woman falls ill and dies on arrival Official Facebook: ...",
        "title": "BA flight to London makes emergency landing after woman falls ill and dies on arrival",
        "done": false,
        "starred": false,
        "tags": [],
        "author": {
          "name": "ARY News",
          "avatar": "https://yt3.ggpht.com/Lwr3mKZG48w7KCkQEvw4s-A_1tspPV-Kyn7UCB3wOccUvKAT7OKzz2wVUXlNbMm9cihFbPMiQg=s88-c-k-c0x00ffffff-no-rj",
          "audience": 7920000,
          "description": "ARY News is a Pakistani news channel launched in 26 September 2004. A bilingual news channel in English and Urdu, it is a part of the ARY Digital Network, which is a subsidiary of ARY Group. ARY is an acronym of Abdul Razzak Yaqoob, who was the owner of ARY Group. ARY NEWS brings you 24/7 Live Streaming, Headlines, Bulletins, Talk Shows, Infotainment and much more. Watch minute by minute updates o...",
          "url": "https://www.youtube.com/channel/UCMmpLL2ucRHAXbNHiCPyIyg"
        },
        "sentiment": "negative",
        "source": "youtube",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "#BritishAirways",
                "start_index": 0,
                "end_index": 15
              }
            ]
          }
        }
      },
      {
        "id": 1100641594,
        "date": 1632386184000,
        "reach": 7919022,
        "language": "en",
        "url": "https://www.youtube.com/watch?v=EtC1TTbHsic",
        "snippet": "#Tashkent #BritishAirways #News #LatestNews Tashkand: ARY News Bana Pakistani Musafiron Ki Awaz Official Facebook: https://www.fb.com/arynewsasia ...",
        "title": "Tashkent: ARY News Bana Pakistani Musafiron Ki Awaz",
        "done": false,
        "starred": false,
        "tags": [],
        "author": {
          "name": "ARY News",
          "avatar": "https://yt3.ggpht.com/Lwr3mKZG48w7KCkQEvw4s-A_1tspPV-Kyn7UCB3wOccUvKAT7OKzz2wVUXlNbMm9cihFbPMiQg=s88-c-k-c0x00ffffff-no-rj",
          "audience": 7910000,
          "description": "ARY News is a Pakistani news channel launched in 26 September 2004. A bilingual news channel in English and Urdu, it is a part of the ARY Digital Network, which is a subsidiary of ARY Group. ARY is an acronym of Abdul Razzak Yaqoob, who was the owner of ARY Group. ARY NEWS brings you 24/7 Live Streaming, Headlines, Bulletins, Talk Shows, Infotainment and much more. Watch minute by minute updates o...",
          "url": "https://www.youtube.com/channel/UCMmpLL2ucRHAXbNHiCPyIyg"
        },
        "source": "youtube",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "#BritishAirways",
                "start_index": 10,
                "end_index": 25
              }
            ]
          }
        }
      },
      {
        "id": 1135873504,
        "date": 1635465600000,
        "reach": 6994064,
        "language": "en",
        "url": "https://www.merriam-webster.com/dictionary/biometrics",
        "snippet": "... Airlines, Aer Lingus, British Airways, Iberia, and Japan Airlines use VeriFly, which was created by biometrics company Daon, where testing and proof ...",
        "title": "Biometrics | Definition of Biometrics by Merriam-Webster",
        "done": false,
        "starred": false,
        "location": {
          "latitude": 39.7837304,
          "longitude": -100.4458825,
          "country": "US"
        },
        "tags": [],
        "author": {
          "name": "merriam-webster.com",
          "avatar": "https://www.google.com/s2/favicons?domain=www.merriam-webster.com",
          "audience": 170000000,
          "url": "www.merriam-webster.com"
        },
        "source": "web",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "British",
                "start_index": 26,
                "end_index": 33
              },
              {
                "text": "Airways",
                "start_index": 34,
                "end_index": 41
              }
            ]
          }
        }
      },
      {
        "id": 967848765,
        "date": 1623486036065,
        "reach": 6424328,
        "language": "en",
        "url": "https://indianexpress.com/article/books-and-literature/end-of-an-era-american-will-drop-its-in-flight-magazine-7355518",
        "snippet": "... dropped theirs, and British Airways stopped stocking paper copies of \"High Life\" while keeping the online version. But the days of the in-flight ...",
        "title": "End of an era: American will drop its in-flight magazine",
        "done": false,
        "starred": false,
        "location": {
          "latitude": 39.7837304,
          "longitude": -100.4458825,
          "country": "US"
        },
        "tags": [],
        "author": {
          "name": "indianexpress.com",
          "avatar": "https://www.google.com/s2/favicons?domain=indianexpress.com",
          "audience": 170000000,
          "url": "indianexpress.com",
          "written_by": "Also Read"
        },
        "sentiment": "negative",
        "source": "news-blogs",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "British",
                "start_index": 24,
                "end_index": 31
              },
              {
                "text": "Airways",
                "start_index": 32,
                "end_index": 39
              }
            ]
          }
        }
      },
      {
        "id": 1135766004,
        "date": 1635462039852,
        "reach": 5666667,
        "language": "es",
        "url": "https://elpais.com/economia/2021-10-28/la-compra-de-air-europa-por-iberia-al-borde-de-la-ruptura.html?ssm=TW_CM_AME",
        "snippet": "... propietario de Iberia y British Airways. Problemas financieros Pero las trabas de competencia no son las únicas con las que se enfrenta esta ...",
        "title": "La compra de Air Europa por Iberia, al borde de la ruptura",
        "done": false,
        "starred": false,
        "tags": [],
        "author": {
          "name": "elpais.com",
          "avatar": "https://www.google.com/s2/favicons?domain=elpais.com",
          "audience": 170000000,
          "url": "elpais.com",
          "written_by": "Hola"
        },
        "source": "news-blogs",
        "entities": {
          "snippet": {
            "highlighted_text": [
              {
                "text": "British",
                "start_index": 28,
                "end_index": 35
              },
              {
                "text": "Airways",
                "start_index": 36,
                "end_index": 43
              }
            ]
          }
        }
      }
    ],
    "next": "eyJmaWx0ZXIiOnsiYWxlcnRJZCI6NTAwMDM3MTYyLCJsaXN0RmlsdGVyIjp7ImRhdGVGcm9tIjoxNTY0NjQ3NDQwMDAwLCJzb3VyY2VXZWIiOnRydWUsInNvdXJjZVR3aXR0ZXIiOmZhbHNlLCJzb3VyY2VGYWNlYm9vayI6ZmFsc2UsInNvdXJjZVlvdXR1YmUiOnRydWUsInNvdXJjZUluc3RhZ3JhbSI6ZmFsc2UsInNvdXJjZU5ld3NBbmRCbG9ncyI6dHJ1ZSwic291cmNlUmVkZGl0Ijp0cnVlLCJsYW5ndWFnZXMiOnsiaW5jbHVkZSI6dHJ1ZSwiaXRlbSI6WyJlbiIsImVzIl19LCJsb2NhdGlvbnMiOnsiaW5jbHVkZSI6dHJ1ZSwibG9jYXRpb25zIjpbeyJjb29yZGluYXRlcyI6bnVsbCwiY291bnRyeUNvZGUiOiJVUyIsInNldHRsZW1lbnQiOm51bGwsInN0YXRlIjpudWxsLCJ6aXAiOm51bGwsInBsYWNlTmFtZSI6bnVsbCwib3NtSWQiOm51bGwsInZlcnNpb24iOjB9LHsiY29vcmRpbmF0ZXMiOm51bGwsImNvdW50cnlDb2RlIjpudWxsLCJzZXR0bGVtZW50IjpudWxsLCJzdGF0ZSI6bnVsbCwiemlwIjpudWxsLCJwbGFjZU5hbWUiOm51bGwsIm9zbUlkIjpudWxsLCJ2ZXJzaW9uIjowfV19LCJtZW50aW9uc1JhbmdlIjp7fX19LCJzb3J0QnkiOiJSRUFDSCIsInNvcnRBc2MiOmZhbHNlLCJsaW1pdCI6Nywib2Zmc2V0Ijo3fQ%3D%3D"
  }
}