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

Authentification

ApiKeyAuth
x-api-key<token>

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

In: header

Paramètres de requête

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.

gl?string

Two-letter country code for the Google search country context.

  • us: United States
  • fr: France
  • gb: United Kingdom
  • de: Germany

Example:

us
Default"us"
hl?string

Two-letter language code for the Google interface language.

  • en: English
  • fr: French
  • de: German
  • es: Spanish

Example:

en
Default"en"
page?number

Page number of search results to retrieve.

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

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"

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/google/search?query=string"

{  "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  }}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}

Google News GET

Précédent

Google Search Autocomplete GET

Suivant