Google Autocomplete Actor

Google autocomplete suggestions with support for different languages and country codes.

Input Schema

The Actor accepts the following input parameter:

Parameter	Type	Required	Description
queries	array (JSON)	Yes	An array of query objects. Each object should have: query (string, required), language (string, optional), country_code (string, optional), cursor_pos (integer, optional).

Note: The input is provided as a JSON array in the Apify input UI (JSON editor). Validation of the object structure is performed in the actor logic, not in the schema.

Example Input

{
    "queries": [
        {
            "query": "windows",
            "language": "en",
            "country_code": "us"
        },
        {
            "query": "london",
            "language": "es",
            "country_code": "uk"
        },
        {
            "query": "dua",
            "language": "de",
            "country_code": "du"
        }
    ]
}

Output Schema

Each suggestion in the output contains:

Field	Type	Description
query	string	The original query string from the input
text	string	The suggestion text (cleaned of HTML)
subtitle	string	Additional subtitle information (if available)
thumbnail	string	Thumbnail URL (if available)
url	string	Direct Google search URL for the suggestion

Example Output

[
    {
        "query": "windows",
        "text": "windows 10",
        "subtitle": "",
        "thumbnail": "",
        "url": "https://www.google.com/search?q=windows+10&hl=en&gl=us"
    },
    {
        "query": "london",
        "text": "london bridge",
        "subtitle": "",
        "thumbnail": "",
        "url": "https://www.google.com/search?q=london+bridge&hl=es&gl=uk"
    }
]

Usage Notes

• Each object in the queries array should have at least a query field (string).
• language, country_code, and cursor_pos are optional. If omitted, defaults are used (language: "ar", country_code: "us").
• If a query object is missing the query field, it will be skipped.
• The input schema is intentionally loose (no nested validation) to maximize compatibility with Apify's input UI. All validation is performed in the actor logic.

Usage Examples

Example 1: Arabic Suggestions for "dwayne"

Input:

{
    "query": "dwayne",
    "language": "ar",
    "country_code": "eg"
}

Expected Output: Arabic-language suggestions for "dwayne" with Egyptian localization.

Example 2: English Suggestions for "python"

Input:

{
    "query": "python",
    "language": "en",
    "country_code": "us"
}

Expected Output: English-language suggestions for "python" with US localization.

Example 3: Spanish Suggestions for "dua lipa"

Input:

{
    "query": "dua lipa",
    "language": "es",
    "country_code": "es"
}

Expected Output: Spanish-language suggestions for "dua lipa" with Spanish localization.

Language and Country Codes

Language Codes Dictionary

Code	Language	Code	Language	Code	Language	Code	Language
af	Afrikaans	ak	Akan	sq	Albanian	am	Amharic
ar	Arabic	hy	Armenian	az	Azerbaijani	eu	Basque
be	Belarusian	bn	Bengali	bh	Bihari	bs	Bosnian
br	Breton	bg	Bulgarian	ca	Catalan	hr	Croatian
cs	Czech	da	Danish	nl	Dutch	en	English
eo	Esperanto	et	Estonian	fi	Finnish	fr	French
fy	Frisian	gl	Galician	ka	Georgian	de	German
el	Greek	gn	Guarani	gu	Gujarati	ht	Haitian Creole
ha	Hausa	he	Hebrew	hi	Hindi	hu	Hungarian
is	Icelandic	id	Indonesian	ga	Irish	it	Italian
ja	Japanese	jv	Javanese	kn	Kannada	kk	Kazakh
rw	Kinyarwanda	ko	Korean	ku	Kurdish	ky	Kyrgyz
la	Latin	lv	Latvian	lt	Lithuanian	mk	Macedonian
mg	Malagasy	ms	Malay	ml	Malayalam	mt	Maltese
mi	Maori	mr	Marathi	mn	Mongolian	ne	Nepali
no	Norwegian	or	Oriya	ps	Pashto	fa	Persian
pl	Polish	pt	Portuguese	pa	Punjabi	qu	Quechua
ro	Romanian	ru	Russian	gd	Scottish Gaelic	sr	Serbian
sh	Serbo-Croatian	st	Sesotho	sn	Shona	sd	Sindhi
si	Sinhalese	sk	Slovak	sl	Slovenian	so	Somali
es	Spanish	sw	Swahili	sv	Swedish	tg	Tajik
ta	Tamil	tt	Tatar	te	Telugu	th	Thai
ti	Tigrinya	tr	Turkish	tk	Turkmen	uk	Ukrainian
ur	Urdu	uz	Uzbek	vi	Vietnamese	cy	Welsh
xh	Xhosa	yi	Yiddish	yo	Yoruba	zu	Zulu

Country Codes Dictionary

Code	Country	Code	Country	Code	Country	Code	Country
af	Afghanistan	al	Albania	dz	Algeria	as	American Samoa
ad	Andorra	ao	Angola	ai	Anguilla	aq	Antarctica
ag	Antigua and Barbuda	ar	Argentina	am	Armenia	aw	Aruba
au	Australia	at	Austria	az	Azerbaijan	bs	Bahamas
bh	Bahrain	bd	Bangladesh	bb	Barbados	by	Belarus
be	Belgium	bz	Belize	bj	Benin	bm	Bermuda
bt	Bhutan	bo	Bolivia	ba	Bosnia and Herzegovina	bw	Botswana
bv	Bouvet Island	br	Brazil	io	British Indian Ocean Territory	bn	Brunei Darussalam
bg	Bulgaria	bf	Burkina Faso	bi	Burundi	kh	Cambodia
cm	Cameroon	ca	Canada	cv	Cape Verde	ky	Cayman Islands
cf	Central African Republic	td	Chad	cl	Chile	cn	China
cx	Christmas Island	cc	Cocos (Keeling) Islands	co	Colombia	km	Comoros
cg	Congo	cd	Congo, Democratic Republic	ck	Cook Islands	cr	Costa Rica
ci	Côte d'Ivoire	hr	Croatia	cu	Cuba	cy	Cyprus
cz	Czech Republic	dk	Denmark	dj	Djibouti	dm	Dominica
do	Dominican Republic	ec	Ecuador	eg	Egypt	sv	El Salvador
gq	Equatorial Guinea	er	Eritrea	ee	Estonia	et	Ethiopia
fk	Falkland Islands	fo	Faroe Islands	fj	Fiji	fi	Finland
fr	France	gf	French Guiana	pf	French Polynesia	tf	French Southern Territories
ga	Gabon	gm	Gambia	ge	Georgia	de	Germany
gh	Ghana	gi	Gibraltar	gr	Greece	gl	Greenland
gd	Grenada	gp	Guadeloupe	gu	Guam	gt	Guatemala
gn	Guinea	gw	Guinea-Bissau	gy	Guyana	ht	Haiti
hm	Heard Island	va	Holy See (Vatican)	hn	Honduras	hk	Hong Kong
hu	Hungary	is	Iceland	in	India	id	Indonesia
ir	Iran	iq	Iraq	ie	Ireland	il	Israel
it	Italy	jm	Jamaica	jp	Japan	jo	Jordan
kz	Kazakhstan	ke	Kenya	ki	Kiribati	kp	North Korea
kr	South Korea	kw	Kuwait	kg	Kyrgyzstan	la	Laos
lv	Latvia	lb	Lebanon	ls	Lesotho	lr	Liberia
ly	Libya	li	Liechtenstein	lt	Lithuania	lu	Luxembourg
mo	Macao	mk	Macedonia	mg	Madagascar	mw	Malawi
my	Malaysia	mv	Maldives	ml	Mali	mt	Malta
mh	Marshall Islands	mq	Martinique	mr	Mauritania	mu	Mauritius
yt	Mayotte	mx	Mexico	fm	Micronesia	md	Moldova
mc	Monaco	mn	Mongolia	ms	Montserrat	ma	Morocco
mz	Mozambique	mm	Myanmar	na	Namibia	nr	Nauru
np	Nepal	nl	Netherlands	an	Netherlands Antilles	nc	New Caledonia
nz	New Zealand	ni	Nicaragua	ne	Niger	ng	Nigeria
nu	Niue	nf	Norfolk Island	mp	Northern Mariana Islands	no	Norway
om	Oman	pk	Pakistan	pw	Palau	ps	Palestinian Territory
pa	Panama	pg	Papua New Guinea	py	Paraguay	pe	Peru
ph	Philippines	pn	Pitcairn	pl	Poland	pt	Portugal
pr	Puerto Rico	qa	Qatar	re	Réunion	ro	Romania
ru	Russian Federation	rw	Rwanda	sh	Saint Helena	kn	Saint Kitts and Nevis
lc	Saint Lucia	pm	Saint Pierre and Miquelon	vc	Saint Vincent	ws	Samoa
sm	San Marino	st	Sao Tome and Principe	sa	Saudi Arabia	sn	Senegal
rs	Serbia	sc	Seychelles	sl	Sierra Leone	sg	Singapore
sk	Slovakia	si	Slovenia	sb	Solomon Islands	so	Somalia
za	South Africa	gs	South Georgia	es	Spain	lk	Sri Lanka
sd	Sudan	sr	Suriname	sj	Svalbard and Jan Mayen	sz	Swaziland
se	Sweden	ch	Switzerland	sy	Syrian Arab Republic	tw	Taiwan
tj	Tajikistan	tz	Tanzania	th	Thailand	tl	Timor-Leste
tg	Togo	tk	Tokelau	to	Tonga	tt	Trinidad and Tobago
tn	Tunisia	tr	Turkey	tm	Turkmenistan	tc	Turks and Caicos Islands
tv	Tuvalu	ug	Uganda	ua	Ukraine	ae	United Arab Emirates
gb	United Kingdom	us	United States	um	US Minor Outlying Islands	uy	Uruguay
uz	Uzbekistan	vu	Vanuatu	ve	Venezuela	vn	Viet Nam
vg	Virgin Islands, British	vi	Virgin Islands, US	wf	Wallis and Futuna	eh	Western Sahara
ye	Yemen	zm	Zambia	zw	Zimbabwe