Piloterr

Google Search

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

Credit cost: 1 credit per call

GET
/v2/google/search

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

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.

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?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"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.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"
}