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
, andgl
(country) parameters together. Alternatively, you can use thelocation
parameter, and ScrapeIN will automatically set thegoogle_domain
,gl
, andhl
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 Code | Language Name |
---|---|
af | Afrikaans |
ak | Akan |
sq | Albanian |
am | Amharic |
ar | Arabic |
hy | Armenian |
az | Azerbaijani |
eu | Basque |
be | Belarusian |
bem | Bemba |
bn | Bengali |
bh | Bihari |
xx-bork | Bork, bork, bork! |
bs | Bosnian |
br | Breton |
bg | Bulgarian |
km | Cambodian |
ca | Catalan |
chr | Cherokee |
ny | Chichewa |
zh-cn | Chinese (Simplified) |
zh-tw | Chinese (Traditional) |
co | Corsican |
hr | Croatian |
cs | Czech |
da | Danish |
nl | Dutch |
xx-elmer | Elmer Fudd |
en | English |
eo | Esperanto |
et | Estonian |
ee | Ewe |
fo | Faroese |
tl | Filipino |
fi | Finnish |
fr | French |
fy | Frisian |
gaa | Ga |
gl | Galician |
ka | Georgian |
de | German |
el | Greek |
gn | Guarani |
gu | Gujarati |
xx-hacker | Hacker |
ht | Haitian Creole |
ha | Hausa |
haw | Hawaiian |
iw | Hebrew |
hi | Hindi |
hu | Hungarian |
is | Icelandic |
ig | Igbo |
id | Indonesian |
ia | Interlingua |
ga | Irish |
it | Italian |
ja | Japanese |
jw | Javanese |
kn | Kannada |
kk | Kazakh |
rw | Kinyarwanda |
rn | Kirundi |
xx-klingon | Klingon |
kg | Kongo |
ko | Korean |
kri | Krio (Sierra Leone) |
ku | Kurdish |
ckb | Kurdish (Soranî) |
ky | Kyrgyz |
lo | Laothian |
la | Latin |
lv | Latvian |
ln | Lingala |
lt | Lithuanian |
loz | Lozi |
lg | Luganda |
ach | Luo |
mk | Macedonian |
mg | Malagasy |
ms | Malay |
ml | Malayalam |
mt | Maltese |
mi | Maori |
mr | Marathi |
mfe | Mauritian Creole |
mo | Moldavian |
mn | Mongolian |
sr-ME | Montenegrin |
ne | Nepali |
pcm | Nigerian Pidgin |
nso | Northern Sotho |
no | Norwegian |
nn | Norwegian (Nynorsk) |
oc | Occitan |
or | Oriya |
om | Oromo |
ps | Pashto |
fa | Persian |
xx-pirate | Pirate |
pl | Polish |
pt | Portuguese |
pt-br | Portuguese (Brazil) |
pt-pt | Portuguese (Portugal) |
pa | Punjabi |
qu | Quechua |
ro | Romanian |
rm | Romansh |
nyn | Runyakitara |
ru | Russian |
gd | Scots Gaelic |
sr | Serbian |
sh | Serbo-Croatian |
st | Sesotho |
tn | Setswana |
crs | Seychellois Creole |
sn | Shona |
sd | Sindhi |
si | Sinhalese |
sk | Slovak |
sl | Slovenian |
so | Somali |
es | Spanish |
es-419 | Spanish (Latin American) |
su | Sundanese |
sw | Swahili |
sv | Swedish |
tg | Tajik |
ta | Tamil |
tt | Tatar |
te | Telugu |
th | Thai |
ti | Tigrinya |
to | Tonga |
lua | Tshiluba |
tum | Tumbuka |
tr | Turkish |
tk | Turkmen |
tw | Twi |
ug | Uighur |
uk | Ukrainian |
ur | Urdu |
uz | Uzbek |
vi | Vietnamese |
cy | Welsh |
wo | Wolof |
xh | Xhosa |
yi | Yiddish |
yo | Yoruba |
zu | Zulu |