# Google Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/google/search` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/google-search |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/google/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'best electric cars 2024'. US/English

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

### Search 'OpenAI ChatGPT' with time filter 'last week'

```json
{
  "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://openai.com/index/powering-product-discovery-in-chatgpt/",
      "title": "Powering Product Discovery in ChatGPT",
      "domain": "openai.com",
      "source": "OpenAI",
      "snippet": "4 days ago. ChatGPT introduces richer, visually immersive shopping powered by the Agentic Commerce Protocol.",
      "position": 1,
      "displayed_link": "https://openai.com › index › powering-product-discove...",
      "snippet_matched": [
        "ChatGPT"
      ]
    },
    {
      "link": "https://www.cnbc.com/2026/03/24/openai-revamps-shopping-experience-in-chatgpt-after-instant-checkout.html",
      "title": "OpenAI revamps shopping experience in ChatGPT after Instant Checkout",
      "domain": "www.cnbc.com",
      "source": "CNBC",
      "snippet": "3 days ago. The update comes after OpenAI pivoted away from Instant Checkout, which allowed users to purchase select items from retailers like Etsy, Walmart and Shopify.",
      "position": 2,
      "displayed_link": "https://www.cnbc.com › 2026/03/24 › openai-revamps-...",
      "snippet_matched": [
        "OpenAI"
      ]
    }
  ],
  "related_searches": [],
  "search_parameters": {
    "q": "OpenAI ChatGPT",
    "gl": "us",
    "hl": "en",
    "tbs": "qdr:w",
    "page": 1,
    "uule": null,
    "engine": "google",
    "location": null
  },
  "search_information": {
    "total_results": null,
    "time_taken_displayed": null
  }
}
```

### Search 'Airbus Company' with Knowledge Graph

```json
{
  "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",
    "attributes": {
      "Owner": "SOGEPA (French Government): 10.9%; GZBV(German Government): 10.8%; SEPI (Spanish Government): 4.1%;",
      "Founded": "December 18, 1970",
      "Founder": "Roger Béteille",
      "Revenue": "65.45 billion EUR (2023)",
      "Headquarters": "Leiden, Netherlands"
    },
    "description": "Airbus SE is a European aerospace corporation. The company's primary business is the design and manufacturing of commercial aircraft.",
    "description_link": "https://en.wikipedia.org/wiki/Airbus",
    "description_source": "Wikipedia"
  },
  "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,
      "displayed_link": "https://www.airbus.com › ...",
      "snippet_matched": [
        "Airbus"
      ]
    }
  ],
  "related_searches": [
    {
      "query": "Airbus headquarters"
    },
    {
      "query": "Boeing"
    },
    {
      "query": "Airbus owner"
    }
  ],
  "search_parameters": {
    "q": "Airbus Company",
    "gl": "us",
    "hl": "en",
    "tbs": null,
    "page": 1,
    "uule": null,
    "engine": "google",
    "location": null
  },
  "search_information": {
    "total_results": null,
    "time_taken_displayed": null
  }
}
```

## Documentation

## Overview
Scrape organic search results from Google for any query. Returns ranked results, knowledge graph, related searches, and pagination info.

## Quickstart
```
POST https://api.piloterr.com/v2/google/search
Content-Type: application/json

{"query": "best electric cars 2024", "gl": "us", "hl": "en"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The Google search query |
| `tbs` | string | no | Time-range filter: `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y` |
| `location` | string | no | City-level location |
| `gl` | string | no | 2-letter country code |
| `hl` | string | no | 2-letter language code |
| `page` | integer | no | Page number for pagination |

## Main use cases
- Build SERP tracking and rank monitoring tools for SEO teams
- Scrape Google results to power lead generation pipelines
- Monitor recent brand mentions using `tbs` time filters
- Extract knowledge graph data to enrich company databases