Skip to content

About

Google Maps API by Autom: Google Maps places, ratings & contacts as JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Google Maps API by Autom

Google Maps API

Discord Get API key API docs License: MIT

The Autom Google Maps API returns Google Maps local results — places, addresses, ratings, reviews count and contact details — as structured JSON.

  • Google Maps API — Search Google Maps via API and retrieve structured place results (address, website, phone).

Use it for local SEO, lead generation, store locators or market mapping.

Endpoint Request Credits
Google Maps API GET /v1/google/maps 1

Table of contents

How it works

  1. Create a Autom account and copy your API key from the dashboard.
  2. Call https://api.autom.dev with the header x-api-key: YOUR_API_KEY.
  3. Use the result in your app — no infrastructure to run.
export AUTOM_API_KEY="your-api-key"
pip install requests        # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`

Google Maps API

Search Google Maps via API and retrieve structured place results (address, website, phone).

GET https://api.autom.dev/v1/google/maps · 1 credit per request · API reference

Request parameters

Parameter In Type Required Description
query query string ✅ Search query for Google Maps (e.g. business type, brand, or place name).
page query number — Page number for pagination (1 = first page).
google_domain query string — Google domain to use for the search. Defaults to google.com.
gl query 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).
hl query 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).
cr query string — Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).
lr query string — Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).
ll query string — Map center / geo hint in Google format (e.g. @43.5131985,1.4600501,60m). Helps focus results around a coordinate and zoom radius.

Python example

import os

import requests

API_KEY = os.environ["AUTOM_API_KEY"]
HEADERS = {"x-api-key": API_KEY}

response = requests.get(
    "https://api.autom.dev/v1/google/maps",
    headers=HEADERS,
    params={
        "query": "bar paris",
    },
    timeout=120,
)
response.raise_for_status()

data = response.json()
print(data)

TypeScript example

type GoogleMapsApi = {
  fid?: string;
  lat?: unknown;
  long?: unknown;
  title?: unknown;
  address?: string;
  website?: string;
  phone_number?: string;
}[];

const headers = { "x-api-key": process.env.AUTOM_API_KEY!, "Content-Type": "application/json" };

const params = new URLSearchParams({
  "query": "bar paris",
});

const response = await fetch(`https://api.autom.dev/v1/google/maps?${params}`, { headers });
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);

const data = (await response.json()) as GoogleMapsApi;
console.log(data);

Output example

Example response from the API reference, abridged.

[
  {
    "fid": "0x12aebf2675445053:0xff6b4af3e0c18407",
    "lat": null,
    "long": null,
    "title": null,
    "address": "Le 153 Bar & Cocktails, 153 Rue Saint-Martin, 75003 Paris",
    "website": "https://www.le153.com/",
    "phone_number": "example"
  }
]

Code examples in other languages

Ready-to-run examples live in examples/; each reads your key from AUTOM_API_KEY.

Language google-maps
cURL (Bash) google_maps.sh
PHP google_maps.php
C# GoogleMaps.cs
Go google_maps.go
Java GoogleMapsExample.java
Ruby google_maps.rb
Node.js google_maps.mjs

Use cases

  • Local SEO — Track local pack rankings per city.
  • Lead generation — Build lists of local businesses by category and area.
  • Market mapping — Map competitors and density by location.

Why Autom?

  • Every SERP in one API — Google Search, AI Mode, Maps, News, Shopping, Images, Videos, Jobs, Autocomplete, plus Bing and Brave.
  • Structured JSON — documented fields instead of brittle HTML parsing.
  • Geo & language targeting — search like a user from the country and language you need.
  • One API key, one header — x-api-key on every request.
  • Copy-paste examples — Python and TypeScript in each README, 7 more languages in examples/.

FAQ

How do I authenticate?

Create an account on Autom, copy your API key and send it in the x-api-key header of every request to https://api.autom.dev.

How much does a request cost?

Credits per call: /v1/google/maps 1. See Autom pricing.

Which languages are supported?

Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.

Official SDKs

Use Autom from your own language with a typed client:

SDK Package Install
Node.js @automdev/sdk npm install @automdev/sdk
Python automdev pip install automdev
Go autom-go go get github.com/automdev/autom-go
.NET Autom dotnet add package Autom
Ruby autom gem install autom
PHP autom/sdk composer require autom/sdk
Java autom-java build from source, see its README
CLI @automdev/cli npm install -g @automdev/cli
MCP server @automdev/mcp npx -y @automdev/mcp

Related repositories

Support


Autom
Built by Autom. Examples are released under the MIT license.

About

Google Maps API by Autom: Google Maps places, ratings & contacts as JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors