Piloterr

Google Search

GET
/v2/google/search

Scrape real-time Google search results with organic listings, knowledge graph, related searches, and advanced filters.

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 to execute on Google. Supports all standard Google search operators.

Examples:

  • best electric cars 2024: standard keyword search
  • site:linkedin.com Bill Gates: restrict results to a specific domain
  • intitle:"growth hacking" startup: match the page title
  • inurl:blog python tutorial: match part of the URL

Example:

best electric cars 2024
tbs?string

Advanced time-range and filter string for Google Search. Used to restrict results by recency.

  • qdr:h: Last hour
  • qdr:d: Last day
  • qdr:w: Last week
  • qdr:m: Last month
  • qdr:y: Last year

Example:

qdr:w
location?string

City or region from which the search should originate. Simulates a real user's search from the specified location.

Examples:

New York, NY
Paris, France
Tokyo, Japan
uule?string

Google-encoded location string for precise geographic targeting.

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
Default"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
Default"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 of search results to retrieve.

  • 1: First page (default)
  • 2: Second page, etc.
Default"1"
num?numberDeprecated

Maximum number of results to return per page (e.g. 10, 40, 100).

Note: This parameter is deprecated and may not reliably affect the number of results returned.

Default"10"
safe?string

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

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?unknown
organic_results?array<>
related_searches?array<>
search_parameters?
search_information?
Example Request
curl -X GET 'https://api.piloterr.com/v2/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": null,  "organic_results": [    {      "link": "https://www.caranddriver.com/rankings/best-electric-cars",      "title": "Best Electric Vehicles for 2026, Tested",      "domain": "www.caranddriver.com",      "source": "Car and Driver",      "snippet": "We've ranked the best electric cars, trucks, and SUVs based on roughly 200 data points encompassing acceleration, handling, comfort, cargo space, fuel economy, and value.",      "position": 1,      "displayed_link": "https://www.caranddriver.com › rankings › best-electric...",      "snippet_matched": [        "best",        "cars",        "electric"      ]    },    {      "link": "https://www.edmunds.com/electric-car/",      "title": "Best Electric Cars of 2026 and 2027 - Expert Reviews and Rankings",      "domain": "www.edmunds.com",      "source": "Edmunds",      "snippet": "Best Electric cars: Tesla Model 3 Long Range, Hyundai IONIQ 6, 2026 Nissan LEAF, 2025 FIAT 500e",      "position": 2,      "displayed_link": "https://www.edmunds.com › electric-car",      "snippet_matched": [        "best",        "cars",        "electric"      ]    },    {      "link": "https://www.topgear.com/car-news/electric/top-gears-top-20-electric-cars",      "title": "Best Electric Cars 2026 - Top Gear",      "domain": "www.topgear.com",      "source": "Top Gear",      "snippet": "Mar 10, 2026. Want a good EV? Here are the 20 best electric cars on sale right now: Kia PV5, Volvo EX90, Skoda Enyaq, Polestar 4, Kia EV6, BMW i5 Touring.",      "position": 3,      "displayed_link": "https://www.topgear.com › top-gears-top-20-electric-cars",      "snippet_matched": [        "best",        "cars",        "electric"      ]    }  ],  "related_searches": [    {      "query": "Best electric cars 2024 hybrid"    },    {      "query": "Best electric cars in the world"    },    {      "query": "Top 10 most reliable electric cars"    }  ],  "search_parameters": {    "q": "best electric cars 2024",    "gl": "us",    "hl": "en",    "tbs": null,    "page": 1,    "uule": null,    "engine": "google",    "location": null  },  "search_information": {    "total_results": null,    "time_taken_displayed": null  }}