An AI-powered Google Maps search integration that fetches detailed local business listings, contact information, GPS coordinates, and user ratings using the Just Serp API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install justserpapi-google-maps-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install justserpapi-google-maps-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Google SERP Maps Search API?
The Google SERP Maps Search API is a powerful technical capability designed to supercharge AI coding agents with high-fidelity local maps search data. Built as one of the essential Openclaw Skills, this tool targets the Just Serp API endpoint GET /api/v1/google/maps/search, giving automated workflows direct access to structured geospatial intelligence.
By calling this skill, agents can seamlessly extract critical commercial details such as operational listings, ratings, reviews, coordinate-level locations, and contact information. This enables automated local market research, high-quality lead generation, and territory mapping without needing complex browser automation or DOM parsing solutions.
Google SERP Maps Search API Use Cases
- Local Lead Generation: Automate the collection of B2B prospects, gathering contact details, ratings, and locations for specific search queries (e.g., 'hospitals in New York').
- Market Analysis & Competitor Auditing: Scrape and analyze competitor footprints, average ratings, and geographic densities across target regions.
- Geospatial and Territory Mapping: Use GPS coordinates (ll) to plot businesses, determine service boundaries, and perform distance analysis.
- Local SEO & Citation Benchmarking: Evaluate how businesses appear on Google Maps SERP to manage citations and search engine visibility.
How Google SERP Maps Search API Works
- Triggering the Search: The AI agent or client application initiates the maps search using a query parameters object with at least a required search query.
- Localization and Filters: Parameters such as coordinate origin (ll), country, domain, and language are optionally appended to localize and refine the search scope.
- API Request Dispatch: The Openclaw execution script forwards the structured request to the Just Serp API endpoint: GET /api/v1/google/maps/search.
- Structured JSON Parsing: The server retrieves real-time Google Maps search listings, including precise business contact details, locations, and metadata.
- Response Delivery: The raw JSON payload is returned to the agent with a concise, developer-friendly execution summary for prompt integration.
Google SERP Maps Search API Setup
To deploy this tool within your ecosystem of Openclaw Skills, set up the required environment and run the execution command.
Prerequisites
- Node.js: Ensure 'node' is installed and available in your path.
- API Credentials: Sign up at Just Serp API to obtain your secret API key.
Environment Setup
Export your Just Serp API key to your system environment:
export JUST_SERP_API_KEY="your_just_serp_api_key_here"
CLI Execution
Execute the maps search operation directly using the CLI:
node {baseDir}/bin/run.mjs \
--operation "mapsSearch" \
--api-key "$JUST_SERP_API_KEY" \
--params-json '{"query":"restaurants in Chicago", "country":"us"}'
Google SERP Maps Search API Data Schema & Taxonomy
The Google Maps Search API structures both input parameters and query results systematically. Below is the specification for the input payload.
Input Query Parameters
| Parameter | Source | Required | Type | Description |
|---|---|---|---|---|
query |
query | Yes | string | The Google Maps search query (e.g., 'dentists'). |
country |
query | No | string | Localizes results to a specific country (e.g., 'us', 'uk'). |
domain |
query | No | string | Google domain to target (e.g., 'google.co.uk'). |
language |
query | No | string | Two-letter code for the localized output language. |
ll |
query | No | string | GPS coordinates formatted as '@latitude,longitude,zoom'. |
page |
query | No | integer | Pagination offset (starts at 0, increment by 20). |
place_id |
query | No | string | Directly targets a specific Google Place for retrieval. |
data |
query | No | string | Advanced custom Maps filter parameters. |
Output Schema
The output returns a structured JSON payload containing business objects, location coordinates, ratings, reviews count, contact numbers, and website URLs perfect for immediate data pipeline ingestion.
Google SERP Maps Search API Advanced Features
- Precise GPS Origin (ll) Targeting: Target micro-local coordinates for hyper-specific regional searches or neighborhood analysis.
- Full Localization: Filter results perfectly by setting localized domains, specific ISO country codes, and multi-language support (e.g., French translation for Paris searches).
- Pagination Support: Step through large quantities of local business leads with native, 20-item incrementing page offset pagination.
- Direct Place Lookup: Retrieve instant full data payloads for unique entities using their Google Place ID without querying the broad SERP.
SKILL.md
Loading
Related Openclaw Skills
Google SERP Local Search API
A specialized search integration to query Google Local SERP data, returning contact details, business listings, and ratings for local lead generation.
Google SERP Maps Places API
An API-driven skill designed to retrieve detailed Google Maps business information, contact details, and location metadata using unique place identifiers.
Google SERP Maps Posts API
A dedicated Openclaw skill to retrieve Google Maps business posts, updates, photos, and promotional feeds via the Just Serp API.
Google SERP Patents Details
An AI-ready integration to query and extract structured Google patent details, including legal status, claims, and abstracts.
Google SERP Maps Reviews API
A focused API skill to retrieve comprehensive Google Maps reviews, ratings, and reviewer metadata for automated reputation analysis and review monitoring.
Google SERP Maps Photos API
A specialized API integration that extracts Google Maps photo data and associated metadata using location IDs for visual analysis and local SEO QA.
METADATA
Featured*
