API Documentation

Google Languages

hl

The hl parameter specifies the Google UI language to return results. By default, the hl value is set to en. However, you can specify any other supported hl 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 hl= followed by your desired value to your API request URL. For example, to return search results in Germany, you would include hl=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 Languages in JSON and CSV format.

List of Google Languages

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

Language CodeLanguage Name
afAfrikaans
akAkan
sqAlbanian
amAmharic
arArabic
hyArmenian
azAzerbaijani
euBasque
beBelarusian
bemBemba
bnBengali
bhBihari
xx-borkBork, bork, bork!
bsBosnian
brBreton
bgBulgarian
kmCambodian
caCatalan
chrCherokee
nyChichewa
zh-cnChinese (Simplified)
zh-twChinese (Traditional)
coCorsican
hrCroatian
csCzech
daDanish
nlDutch
xx-elmerElmer Fudd
enEnglish
eoEsperanto
etEstonian
eeEwe
foFaroese
tlFilipino
fiFinnish
frFrench
fyFrisian
gaaGa
glGalician
kaGeorgian
deGerman
elGreek
gnGuarani
guGujarati
xx-hackerHacker
htHaitian Creole
haHausa
hawHawaiian
iwHebrew
hiHindi
huHungarian
isIcelandic
igIgbo
idIndonesian
iaInterlingua
gaIrish
itItalian
jaJapanese
jwJavanese
knKannada
kkKazakh
rwKinyarwanda
rnKirundi
xx-klingonKlingon
kgKongo
koKorean
kriKrio (Sierra Leone)
kuKurdish
ckbKurdish (Soranî)
kyKyrgyz
loLaothian
laLatin
lvLatvian
lnLingala
ltLithuanian
lozLozi
lgLuganda
achLuo
mkMacedonian
mgMalagasy
msMalay
mlMalayalam
mtMaltese
miMaori
mrMarathi
mfeMauritian Creole
moMoldavian
mnMongolian
sr-MEMontenegrin
neNepali
pcmNigerian Pidgin
nsoNorthern Sotho
noNorwegian
nnNorwegian (Nynorsk)
ocOccitan
orOriya
omOromo
psPashto
faPersian
xx-piratePirate
plPolish
ptPortuguese
pt-brPortuguese (Brazil)
pt-ptPortuguese (Portugal)
paPunjabi
quQuechua
roRomanian
rmRomansh
nynRunyakitara
ruRussian
gdScots Gaelic
srSerbian
shSerbo-Croatian
stSesotho
tnSetswana
crsSeychellois Creole
snShona
sdSindhi
siSinhalese
skSlovak
slSlovenian
soSomali
esSpanish
es-419Spanish (Latin American)
suSundanese
swSwahili
svSwedish
tgTajik
taTamil
ttTatar
teTelugu
thThai
tiTigrinya
toTonga
luaTshiluba
tumTumbuka
trTurkish
tkTurkmen
twTwi
ugUighur
ukUkrainian
urUrdu
uzUzbek
viVietnamese
cyWelsh
woWolof
xhXhosa
yiYiddish
yoYoruba
zuZulu