# Google Maps

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/google/maps` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/google-maps |

## Description

Extract comprehensive company data from Google Maps for enhanced business insights.

## 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/maps' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "status": "OK",
  "results": [
    {
      "name": "Restaurant Example 1",
      "rating": 4.5,
      "address": "123 Sample Street, Toulouse",
      "website": "http://www.restaurantexample1.com",
      "coordinates": {
        "lat": 43.6,
        "lng": 1.45
      },
      "phone_number": "+33 1 23 45 67 89",
      "user_reviews": [
        {
          "user": "John Doe",
          "rating": 5,
          "comment": "Amazing food and ambiance."
        },
        {
          "user": "Jane Smith",
          "rating": 4,
          "comment": "Good service, but a bit pricey."
        }
      ]
    },
    {
      "name": "Restaurant Example 2",
      "rating": 4,
      "address": "456 Demo Avenue, Toulouse",
      "website": "http://www.restaurantexample2.com",
      "coordinates": {
        "lat": 43.605,
        "lng": 1.455
      },
      "phone_number": "+33 1 98 76 54 32",
      "user_reviews": [
        {
          "user": "Alice Brown",
          "rating": 5,
          "comment": "Fantastic vegetarian options!"
        },
        {
          "user": "Bob White",
          "rating": 3.5,
          "comment": "Nice place, but the food took a while to arrive."
        }
      ]
    },
    {
      "name": "Restaurant Example 3",
      "rating": 3.8,
      "address": "789 Example Boulevard, Toulouse",
      "website": "http://www.restaurantexample3.com",
      "coordinates": {
        "lat": 43.61,
        "lng": 1.46
      },
      "phone_number": "+33 1 11 22 33 44",
      "user_reviews": [
        {
          "user": "Charlie Black",
          "rating": 4,
          "comment": "Unique dishes and friendly staff."
        },
        {
          "user": "Dana Green",
          "rating": 3.5,
          "comment": "Could improve on cleanliness."
        }
      ]
    }
  ]
}
```

## Documentation

## Overview
Extract comprehensive company data from Google Maps for enhanced business insights.

## Quickstart
```
GET https://api.piloterr.com/v2/google/maps?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Google Maps data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Google without maintaining scrapers
- Power internal dashboards and workflow automations with live Google data