Autom

Google Search

GET
/v1/google/search

Scrape Google Search results via API and retrieve structured SERP data with pagination.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The search query you want to run on Google (supports advanced operators like site:, inurl:, intitle:).

tbs?string

Advanced search filters string (e.g. time ranges: qdr:h last hour, qdr:d last day, qdr:w last week, qdr:m last month, qdr:y last year).

safe?string

Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default.

location?string

Human-readable location to originate the search from (e.g. New York, NY, Paris, France). If several locations match, the most popular one is used. Note: location and uule cannot be used together.

uule?string

Google encoded location parameter. Use for precise geo targeting. Note: uule and location cannot be used together.

google_domain?string

Google domain to use for the search. Defaults to google.com.

Examples:

  • google.com
  • google.co.uk
  • google.fr

Example:

google.com
Default"google.com"
gl?string

Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).

Example:

us
hl?string

Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).

Example:

en
cr?string

Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).

Example:

countryUS
lr?string

Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).

Example:

lang_en
page?number

Page number / offset used for pagination.

Default"1"
num?numberDeprecated

Maximum number of results to return per page (deprecated).

Default"10"
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
pagination?
knowledge_graph?
organic_results?array<>
search_parameters?
Example Request
curl -X GET 'https://api.autom.dev/v1/google/search?query=string'
Example Response
{  "pagination": {    "next": 2,    "current": 1,    "other_pages": [      2,      3,      4,      5,      6,      7,      8,      9,      10    ],    "has_next_page": true  },  "knowledge_graph": {    "type": "Aircraft manufacturing commercial company",    "title": "Airbus SE",    "website": "https://www.airbus.com/en"  },  "organic_results": [    {      "link": "https://www.airbus.com/en",      "title": "Airbus: Pioneering sustainable aerospace",      "domain": "www.airbus.com",      "source": "Airbus",      "snippet": "Airbus designs, manufactures and delivers industry-leading commercial aircraft, helicopters, military transports, satellites, launchers and more.",      "position": 1    }  ],  "search_parameters": {    "q": "Airbus Company",    "gl": "us",    "hl": "en",    "page": 1,    "engine": "google"  }}