Skip to main content
All CollectionsAlerts Management
Geolocation Monitoring in Alerts
Geolocation Monitoring in Alerts

Discover how to monitor specific countries in your alerts!

Valerie Paris avatar
Written by Valerie Paris
Updated over 4 months ago

This article is designed to teach you how to filter mentions to specific countries in the three different alert types. It will also show you how to include mentions that do not have geolocation data.

Please note that Mention only provides the ability to filter per country - not by city or state.

Basic Alerts

Within your Mention Alerts, you have the option of applying a country filter that will allow you to monitor or block specific countries from your keyword search. Mention utilizes data from the web and social media to identify the location of each publication we fetch to your account.

Configuring Country Filters

You can configure country filters at any time in the alert configuration page. When you create or edit an alert, the configuration page will display a tab titled Countries and Languages:

By default, your alert will be set to monitor All Countries and will monitor any publication that mentions your keywords, even if the mention does not provide country data.

To monitor specific countries:

  1. Click on the slider titled 'I want to select specific countries' to make the country menu appear.

  2. Select the countries you wish to monitor.

📖 Tip: If you decide to monitor specific countries, we recommend clicking on the Unknown Country filter to ensure you do not miss relevant data from websites that do not display their country data.

⚙️ If you modify your alert with country filters after alert creation, Mention will begin to monitor new mentions with the country preferences in mind.

💡 Bonus Tip: The Alert Creation Assistant will provide you with recommendations for country or language filters in your alert. After you create a keyword search, the assistant will let you know which countries and languages mention your keywords the most.

Standard Alerts

You can modify your country filters at any time using the alert configuration page. When you create or edit an alert, the Alert Creation page will display a tab titled Countries and Languages.

By default, your Alert will be monitoring all countries. To choose specific countries to monitor:

  1. Click on the slider titled 'I want to monitor specific countries' to gain access to the country menu.

  2. Select the countries you wish to monitor.

📖 Tip: Similar to Basic Alerts, we recommend using the Unknown Country filter to ensure you do not miss relevant data from websites that do not display their country data.

Advanced Alerts

Within the Advanced Alert, you have access to boolean operators dedicated to monitoring or blocking countries from your alerts. The operators available are:

  • source_country: This operator allows you to monitor or block countries using their dedicated ISO 3166-1 alpha-2 codes.

  • -has:source_country This operator will monitor mentions that do not have a country code.

Examples

To monitor specific countries:

"Nike Air Max" AND source_country:(FR OR ES)

This query will fetch mentions when the text "Nike Air Max" appears in publications from France or Spain.

To monitor mentions without a country code:

Starbucks AND (source_country:(FR) OR -has:source_country)

This query will fetch mentions from France and from websites that do not have a listed country code.

⚙️ The country operators will only fetch mentions from Web, News, Blogs, Forums, and Twitter/X. If you need to create a query to monitor other sources and specific countries, please contact your dedicated account manager.


Sources Without Geolocation Data

Unfortunately, not every article or social mention informs us of the country it comes from. When this happens, we mark these mentions as undetected.


Mention Fetches Geolocation Data for the Following Sources:

  • Facebook

  • Twitter*

  • Instagram**

  • Forums

  • Blogs

  • Video

  • News

  • Web

  • Pinterest

  • YouTube

  • Twitter Monitored Page

  • Review Pages

Sources with an asterix may be subject to additional restrictions, listed below.


Geolocation Info is not Fetched for the Following Sources:

  • Radio & TV in Us & Canada

  • TikTok

  • Facebook Monitored Pages

  • Instagram Monitored Pages

  • Linkedin

  • LinkedIn Monitored Page

Twitter Source Country: On July 9th, 2024, X (Twitter) made changes to its API. Due to the changes, we can no longer determine the country the post originated from, in most cases. Going forward, the country will be deduced from the geolocation based on the place/location tagged in the tweet itself. This means that an individual would need to click on “location” and tag their location while they are writing the post, in order for a geolocation to be determined. If the location is not tagged, we cannot determine which country the post came from.

This new method does not match:

  • Retweets, as the location is tied to the original post.

  • Quote Tweets, as the location is also tied to the original post.

As a result, you might see fewer mentions, since mentions without a tagged location are no longer matched.

Instagram Source Country: Mention uses information from the author's profile to determine the location. As such, many users opt not to share their location information. Therefore, we recommend including Unknown Country if you are monitoring Instagram.

⚙️ For instructions on how to monitor mentions that do not have geolocation data, please see the rest of the guide below.


How To Monitor Mentions without Country Information

Unfortunately, not every article or social mention informs us of the country it comes from. When this happens, we mark these mentions as undetected.

Basic Alerts

To ensure you track mentions without country data codes:

  1. Hover over the alert you want to adjust and click on Edit.

  2. In Alert Settings, you will see Monitored Countries. Uncheck the 'All Countries' box to access the drop-down menu.

  3. Check the box titled Get Mentions without Country Information.

  4. Save your alert.

Standard Alerts

To monitor mentions without country information:

  1. Hover over the alert you want to adjust and click on Edit.

  2. In Alert Settings, you will see Monitored Countries. Uncheck the 'All Countries' box to access the drop-down menu.

  3. Check the box titled Get Mentions without Country Information.

  4. Save your alert.

Advanced Alerts

To monitor mentions without country information using a Boolean Query, add the following operator:

-has:source_country

Example query:

"Nike Air Max" AND -has:source_country

This query will fetch mentions of "Nike Air Max" from undetected countries.

Combining Specific and Undetected Countries

You can combine specific countries and undetected countries in the same query. For instance:

"Nike Air Max" AND (source_country:(FR) OR -has:source_country) AND lang:fr

This query will fetch mentions of "Nike Air Max" either from France or from undetected countries, provided the mentions are in French.

For a comprehensive list of country codes and proper monitoring with country codes, please check out the article: Country Codes for Advanced Alerts.


Countries Monitoring Shortcuts for the Advanced Alert:

To save time, we have compiled quick shortcuts for country monitoring based on specific regions. Please feel free to copy these shortcuts into your boolean query to monitor specific countries:

--

If you want to monitor all the European countries, you can use the following shortcut:

AND source_country:(AL OR AD OR AM OR AT OR AZ OR BY OR BE OR BA OR BG OR HR OR CY OR CZ OR DK OR EE OR FI OR FR OR GE OR DE OR GR OR HU OR IE OR IT OR KZ OR LV OR LI OR LT OR LU OR MT OR MD OR MC OR ME OR NL OR NO OR PL OR PT OR RO OR RU OR SM OR RS OR SK OR SI OR ES OR SE OR CH OR TR OR UA OR GB)

Did you know? You can type "Europe" in the Boolean Editor, and auto-fill this shortcut?

--

If you want to monitor all African countries, you can use this shortcut:

Source_country: ("DZ" OR "AO" OR "BJ" OR "BW" OR "BF" OR "BI" OR "CM" OR "CV" OR "CF" OR "TD" OR "KM" OR "CG" OR "CD" OR "CI" OR "DJ" OR "EG" OR "GQ" OR "ER" OR "ET" OR "GA" OR "GM" OR "GH" OR "GN" OR "GW" OR "KE" OR "LS" OR "LR" OR "LY" OR "MG" OR "ML" OR "MW" OR "MR" OR "MU" OR "YT" OR "MA" OR "MZ" OR "NA" OR "NE" OR "NG" OR "RE" OR "RW" OR "ST" OR "SN" OR "SC" OR "SL" OR "SO" OR "ZA" OR "SS" OR "SD" OR "SZ" OR "TZ" OR "TG" OR "TN" OR "UG" OR "EH" OR "ZM" OR "ZW")

Did you know? You can type "Africa" in the Boolean Editor, and auto-fill this shortcut?

--

If you need to monitor all the Middle East countries, you can copy paste this in your Boolean query:

AND source_country:(AT OR BE OR BG OR HR OR CY OR CZ OR DK OR EE OR FI OR FR OR DE OR GR OR HU OR IE OR IT OR LV OR LI OR LT OR LU OR MT OR MD OR MC OR NL OR NO OR PL OR PT OR RO OR RU OR SM OR RS OR SK OR SI OR ES OR SE OR CH OR TR OR UA OR GB OR AE OR QA OR SA OR JO OR LB OR IQ OR IN OR IL OR EG OR OM OR BH OR KW)

Did you know? You can type "Middle East" in the Boolean Editor, and auto-fill this shortcut?

--

If you need to monitor all the LATAM countries:

Did you know? You can type "Latam" in the Boolean Editor, and auto-fill this shortcut?

AND source_country:(BR OR PE OR MX OR CO OR AR OR VE OR CL OR EC OR GT OR CU OR BO OR DO O

List of Country Codes:

Mention has the ability to monitor any ISO 3166-1 alpha-2 code. Below , we have provided a list of some of these country codes to assist with your monitoring! Please feel free to use Command+F / Ctrl +F to easily search for a specific country you want to monitor:

List of Country Codes

Afghanistan - AF

Aland islands - AX

Albania - AL

Algeria - DZ

American Samoa - AS

Andorra - AD

Angola - AO

Anguilla - AI

Antarctica - AQ

Antigua and Barbuda - AG

Argentina - AR

Armenia - AM

Aruba - AW

Australia - AU

Austria - AT

Azerbaijan - AZ

Bahamas - BS

Bahrain - BH

Bangladesh - BD

Barbados - BB

Belarus - BY

Belgium - BE

Belize - BZ

Benin - BJ

Bermuda - BM

Bhutan - BT

Bolivia - BO

Bosnia & Herzegovina - BA

Botswana - BW

Bouvet Island - BV

Brazil - BR

British Indian Ocean territory - IO

Brunei - BN

Bulgaria - BG

Burkina Faso - BF

Burundi - BI

Cambodia - KH

Cameroon - CM

Canada - CA

Cape Verde

Caribbean Netherlands

Cayman Islands - KY

Central African Republic - CF

Chad - TD

Chile - CL

China - CN

Christmas Island - CX

Cocos (Keeling) Islands - CC

Colombia - CO

Comoros - KM

Congo - Brazzaville - CG

Congo - Kinshasa - CD

Cook Islands - CK

Costa Rica - CR

Côte d'Ivoire - CI

Croatia - HR

Cuba - CU

Curaçao - CW

Cyprus - CY

Czechia - CZ

Denmark - DK

Djibouti - DJ

Dominica - DM

Dominican Republic - DO

Ecuador - EC

Egypt - EG

El Salvador - SV

Equatorial Guinea - GQ

Eritrea - ER

Eswatini - SZ

Falkland Islands - FK

Faroe Islands - FO

Fiji - FJ

Finland - FI

France - FR

French Guinea - GF

French Polynesia - PF

French Southern Territories - TF

Gabon - GA

Gambia - GM

Georgia - GE

Germany - DE

Ghana - GH

Gibraltar - GI

Greece - GR

Greenland - GL

Grenada - GD

Guadalupe - GP

Guam - GU

Guatemala - GT

Guernsey - GG

Guinea - GN

Guinea - Bissau - GW

Guyana - GY

Haiti - HT

Heard & McDonald Islands - HM

Honduras - HN

Hong Kong SAR China - HK

Hungary - HU

Iceland - IS

India - IN

Indonesia - ID

Iran - IR

Iraq - IQ

Ireland - IE

Isle of Man - IM

Israel - IL

Italy - IT

Jamaica - JM

Japan - JP

Jersey - JE

Jordan - JO

Kazakhstan - KZ

Kenya - KE

Kiribati - KI

Kuwait - KW

Kyrgyzstan - KG

Laos - LA

Latvia - LV

Lebanon - LB

Lesotho - LS

Liberia - LR

Libya - LY

Liechtenstein - LI

Lithuania - LT

Macao SAR China - MO

Madagascar - MG

Malawi - MW

Malaysia - MY

Maldives - MV

Mali - ML

Malta - MT

Marshal islands - MH

Martinique - MQ

Mauritania - MR

Mauritius - MU

Mayotte - YT

Mexico - MX

Micronesia - FM

Moldova - MD

Monaco - MC

Mongolia - MN

Montenegro - ME

Montserrat - MS

Morocco - MA

Mozambique - MZ

Myanmar (Burma) - MM

Namibia - NA

Nauru - NR

Nepal - NP

Netherlands - NL

New Caledonia - NC

New Zealand - NZ

Nicaragua - NI

Niger - NE

Nigeria - NG

Niue - NU

Norfolk Island - NF

North Korea - KP

North Macedonia - MK

Northern Mariana Islands - MP

Norway - NO

Oman - OM

Pakistan - PK

Palau - PW

Palestinian territories - PS

Panama - PA

Papúa New Guinea - PG

Paraguay - PY

Peru - PE

Philippines - PH

Pitcairn Islands - PN

Poland - PL

Portugal - PT

Puerto Rico - PR

Qatar - QA

Reunion - RE

Romania - RO

Russia - RU

Rwanda - RW

Samoa - WS

San Marino - SM

São Tomé and Principe - ST

Saudi Arabia - SA

Senegal - SN

Serbia - RS

Seychelles - SC

Sierra Leone - SL

Singapore - SG

Sint Maarten - SX

Slovakia - SK

Slovenia - SI

Solomon Islands - SB

Somalia - SO

South Africa - ZA

South Georgia & Sandwich islands - GS

South Korea - KR

South Sudan - SS

Spain - ES

Sri Lanka - LK

St. Barthelemy - BL

St. Helena - SH

St. Kitts & Nevis - KN

St. Lucia - LC

St. Martin - MF

St. Pierre and Miquelon - PM

St. Vincent and Grenadines - VC

Sudan - SD

Suriname - SR

Svalbard & Jan Mayen - SJ

Sweden - SE

Switzerland - CH

Syria - SY

Taiwan - TW

Tajikistan - TJ

Tanzania - TZ

Thailand - TH

Timor - Lester - TL

Togo - TG

Tokelau - TK

Tonga - TO

Trinidad and Tobago - TT

Tunisia - TN

Turkey - TR

Turkmenistan - TM

Turks and Caicos Islands - TC

Tuvalu - TV

US Outlying Islands - UM

US Virgin Islands - VI

Uganda - UG

Ukraine - UA

United Arab Emirates - AE

United Kingdom - GB

United States - US

Uruguay - UY

Uzbekistan - UZ

Vanuatu - VU

Vatican City

Venezuela - VE

Vietnam - VN

Wallis & Futuna - WF

Western Sahara - EH

Yemen - YE

Zambia - ZM

Zimbabwe - ZW

⚙️ Please be aware that this is not the full list of country codes. If you would like to review the full list, please head on over to the ISO website and search by country codes:


This content provides a clear, organized, and detailed guide for users to understand and apply country monitoring filters in Mention.

Did this answer your question?