Google Search

PythonSearch

POST api.upapi.io/google-search.post

Search Google and get organic results (title, URL, snippet, domain) for any query, with language and country control. For query suggestions use google-autocomplete.post; for a lighter general web search use web-search.post.

googlesearchserpscrape

AuthAPI key

Cost6 units

Timeout60s

Cache300s

Request schema

Field	Type	Description
`query`req	string	Search query
`country`	string	gl param (e.g. us, ca, gb)· default: `"us"`
`language`	string	hl param (e.g. en, fr, es)· default: `"en"`
`proxyUrl`		Optional proxy URL (http://user:pass@host:port). If set, uses only this exit IP for the BotGuard mint + scrape.· default: `null`
`maxResults`	integer	Max results to return· default: `10`

Response schema

Field	Type	Description
`query`req	string
`source`	string	· default: `"google"`
`message`req	string
`results`req	array
`success`req	boolean
`elapsedMs`req	integer
`fetchedAt`req	string
`totalResults`req	integer

Try it

queryrequired

Search query

countryoptional· default: us

gl param (e.g. us, ca, gb)

languageoptional· default: en

hl param (e.g. en, fr, es)

proxyUrloptional· default: null

Optional proxy URL (http://user:pass@host:port). If set, uses only this exit IP for the BotGuard mint + scrape.

maxResultsoptional· default: 10

Max results to return

Run this endpoint live

Jump in as a guest — no signup — and run google-search.post with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/google-search.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "query": "typescript", "country": "us", "language": "en", "maxResults": 10 }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.