API Documentation

Google Countries

gl

The gl parameter specifies the Google country to use for the query. By default, the gl value is set to us. However, you can specify any other supported gl value by referring to the full list of supported values available here.

📘

Localized results

To achieve localized search results, use the hl (language), google_domain, and gl (country) parameters together. Alternatively, you can use the location parameter, and ScrapeIN will automatically set the google_domain, gl, and hl parameters based on the given location.

To use this parameter, simply append gl= followed by your desired value to your API request URL. For example, to use the Google country for Germany, you would include gl=de in your API request.

https://app.scrapein.app/api/v1/google/?api_key={api-key}&q=milk&google_domain=google.de&hl=de&gl=de
curl --request GET \
     --url 'https://app.scrapein.app/api/v1/google/news/?q=milk&google_domain=google.de&hl=de&gl=de&api_key={api-key}' \
     --header 'accept: application/json'

location

To obtain localized results, it is important to use the location parameter correctly, as ScrapeIN will set the necessary parameters, such as google_domain and gl and hl, automatically to match the specified location.

For example, to search for the phrase milk using the google.de (Google Germany) domain the ScrapeIN search request would be:

https://app.scrapein.app/api/v1/google/?api_key={api-key}&q=milk&location=Germany
curl --request GET \
     --url 'https://app.scrapein.app/api/v1/google/news/?q=milk&location=Germany&&api_key={api-key}' \
     --header 'accept: application/json'

Download

Additionally, you can download a complete list of ScrapeIN Google Countries in JSON and CSV format.

List of Google Countries

The search parameter named gl can take any of the values listed below.

Country NameCountry Code
Afghanistanaf
Albaniaal
Algeriadz
American Samoaas
Andorraad
Angolaao
Anguillaai
Antarcticaaq
Antigua and Barbudaag
Argentinaar
Armeniaam
Arubaaw
Australiaau
Austriaat
Azerbaijanaz
Bahamasbs
Bahrainbh
Bangladeshbd
Barbadosbb
Belarusby
Belgiumbe
Belizebz
Beninbj
Bermudabm
Bhutanbt
Boliviabo
Bosnia and Herzegovinaba
Botswanabw
Bouvet Islandbv
Brazilbr
British Indian Ocean Territoryio
Brunei Darussalambn
Bulgariabg
Burkina Fasobf
Burundibi
Cambodiakh
Camerooncm
Canadaca
Cape Verdecv
Cayman Islandsky
Central African Republiccf
Chadtd
Chilecl
Chinacn
Christmas Islandcx
Cocos (Keeling) Islandscc
Colombiaco
Comoroskm
Congocg
Congo, the Democratic Republic of the Congocd
Cook Islandsck
Costa Ricacr
Cote D'ivoireci
Croatiahr
Cubacu
Cypruscy
Czech Republiccz
Denmarkdk
Djiboutidj
Dominicadm
Dominican Republicdo
Ecuadorec
Egypteg
El Salvadorsv
Equatorial Guineagq
Eritreaer
Estoniaee
Ethiopiaet
Falkland Islands (Malvinas)fk
Faroe Islandsfo
Fijifj
Finlandfi
Francefr
French Guianagf
French Polynesiapf
French Southern Territoriestf
Gabonga
Gambiagm
Georgiage
Germanyde
Ghanagh
Gibraltargi
Greecegr
Greenlandgl
Grenadagd
Guadeloupegp
Guamgu
Guatemalagt
Guineagn
Guinea-Bissaugw
Guyanagy
Haitiht
Heard Island and Mcdonald Islandshm
Holy See (Vatican City State)va
Hondurashn
Hong Konghk
Hungaryhu
Icelandis
Indiain
Indonesiaid
Iran, Islamic Republic ofir
Iraqiq
Irelandie
Israelil
Italyit
Jamaicajm
Japanjp
Jordanjo
Kazakhstankz
Kenyake
Kiribatiki
Korea, Democratic People's Republic of Koreakp
Korea, Republic ofkr
Kuwaitkw
Kyrgyzstankg
Lao People's Democratic Republicla
Latvialv
Lebanonlb
Lesothols
Liberialr
Libyan Arab Jamahiriyaly
Liechtensteinli
Lithuanialt
Luxembourglu
Macaomo
Macedonia, the Former Yugosalv Republic of Macedoniamk
Madagascarmg
Malawimw
Malaysiamy
Maldivesmv
Maliml
Maltamt
Marshall Islandsmh
Martiniquemq
Mauritaniamr
Mauritiusmu
Mayotteyt
Mexicomx
Micronesia, Federated States of Micronesiafm
Moldova, Republic ofmd
Monacomc
Mongoliamn
Montserratms
Moroccoma
Mozambiquemz
Myanmarmm
Namibiana
Naurunr
Nepalnp
Netherlandsnl
Netherlands Antillesan
New Caledonianc
New Zealandnz
Nicaraguani
Nigerne
Nigeriang
Niuenu
Norfolk Islandnf
Northern Mariana Islandsmp
Norwayno
Omanom
Pakistanpk
Palaupw
Palestinian Territory, Occupiedps
Panamapa
Papua New Guineapg
Paraguaypy
Perupe
Philippinesph
Pitcairnpn
Polandpl
Portugalpt
Puerto Ricopr
Qatarqa
Reunionre
Romaniaro
Russian Federationru
Rwandarw
Saint Helenash
Saint Kitts and Neviskn
Saint Lucialc
Saint Pierre and Miquelonpm
Saint Vincent and the Grenadinesvc
Samoaws
San Marinosm
Sao Tome and Principest
Saudi Arabiasa
Senegalsn
Serbia and Montenegrors
Seychellessc
Sierra Leonesl
Singaporesg
Slovakiask
Sloveniasi
Solomon Islandssb
Somaliaso
South Africaza
South Georgia and the South Sandwich Islandsgs
Spaines
Sri Lankalk
Sudansd
Surinamesr
Svalbard and Jan Mayensj
Swazilandsz
Swedense
Switzerlandch
Syrian Arab Republicsy
Taiwan, Province of Chinatw
Tajikistantj
Tanzania, United Republic of Tanzaniatz
Thailandth
Timor-Lestetl
Togotg
Tokelautk
Tongato
Trinidad and Tobagott
Tunisiatn
Turkeytr
Turkmenistantm
Turks and Caicos Islandstc
Tuvalutv
Ugandaug
Ukraineua
United Arab Emiratesae
United Kingdomuk
United Kingdomgb
United Statesus
United States Minor Outlying Islandsum
Uruguayuy
Uzbekistanuz
Vanuatuvu
Venezuelave
Viet Namvn
Virgin Islands, Britishvg
Virgin Islands, U.S.vi
Wallis and Futunawf
Western Saharaeh
Yemenye
Zambiazm
Zimbabwezw