← Back to Skills Marketplace
justserpapi

Google SERP Maps Search API

by justserpapi · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
29
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install justserpapi-google-maps-search
Description
Call GET /api/v1/google/maps/search for Google SERP Maps Search through Just Serp API with query.
README (SKILL.md)

Google SERP Maps Search

Use this focused Just Serp API skill for Google SERP Maps Search. It targets GET /api/v1/google/maps/search. Required inputs are query. OpenAPI describes it as: Get Google maps Search data, including business listings, ratings and contact data, and coordinate and location targeting, for local market research and lead discovery.

Endpoint Scope

  • Group key: google
  • Endpoint key: maps/search
  • Group family: Google SERP
  • Skill slug: justserpapi-google-maps-search
Operation Version Method Path OpenAPI summary
mapsSearch v1 GET /api/v1/google/maps/search Search

Inputs

Parameter In Required by Optional by Type Notes
country query n/a all string Set the target country code (e.g., 'us', 'uk') to localize results. See \x3Ca href="/reference/google-countries">Google Countries\x3C/a>
data query n/a all string Advanced Google Maps data parameter used for certain map/place-specific result filters and views. It can be copied from a Google Maps URL after applying filters, or constructed for specific place searches. This parameter is commonly used when type = "place". If you’re not familiar with it, you can leave it empty
domain query n/a all string The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See \x3Ca href="/reference/google-domains">Google Domains\x3C/a>
language query n/a all string Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See \x3Ca href="/reference/google-language">Google Language\x3C/a>
ll query n/a all string GPS coordinates for the search origin. Format: '@\x3Clatitude>,\x3Clongitude>,\x3Czoom>'. Required for precise localization and pagination
page query n/a all integer The results pagination offset. Start at 0 and increment by 20 for each subsequent page
place_id query n/a all string The unique Google Place ID to directly retrieve information for a specific location
query query all n/a string The search query for Google Maps (e.g., 'restaurants', 'hospitals in New York')

Request body: none documented; send parameters through path or query arguments.

Version Choice

Use mapsSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: mapsSearch.

node {baseDir}/bin/run.mjs --operation "mapsSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"\x3Cquery>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.

Environment

  • Required: JUST_SERP_API_KEY
  • Pass the API key with --api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs.
  • Project site: Just Serp API.
  • Authentication details: Just Serp API Docs.

Output Focus

  • State the operation ID and endpoint path used, for example mapsSearch on /api/v1/google/maps/search.
  • Echo the required lookup scope (query) before summarizing results.
  • Prioritize fields that support this endpoint purpose: Get Google maps Search data, including business listings, ratings and contact data, and coordinate and location targeting, for local market research and lead discovery.
  • Return raw JSON only after the short, endpoint-specific summary.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
Install only if you are comfortable sending Google Maps search terms, optional GPS coordinates, place IDs, and localization parameters to Just Serp API using your API key. Avoid submitting sensitive personal locations or confidential business searches unless that third-party handling is acceptable for your use case.
Capability Tags
requires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
The stated purpose, documentation, manifest, and helper script all align around one GET request to /api/v1/google/maps/search for maps search results.
ℹ Instruction Scope
The skill asks the agent to collect missing required inputs and preserve user-provided query values; optional location, place, country, language, and pagination parameters are documented.
✓ Install Mechanism
The artifacts contain documentation, a generated operations manifest, and a Node helper script; there are no package install hooks, hidden setup steps, or self-modifying behavior.
ℹ Credentials
Requiring JUST_SERP_API_KEY and Node is proportionate for a third-party API integration, but users should understand that precise map searches or coordinates leave the local environment.
✓ Persistence & Privilege
Manual review found no persistence, background worker, local indexing, local file reads, credential-store access, privilege escalation, or mutation of user data.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justserpapi-google-maps-search
  3. After installation, invoke the skill by name or use /justserpapi-google-maps-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated operation summary for `mapsSearch` from "Maps Search" to "Search". - Removed the file `skill-card.md`. - SKILL.md and documentation files updated for clarity and consistency with API documentation. - No functional or interface changes to endpoint usage or input parameters.
v1.0.0
Initial publish
Metadata
Slug justserpapi-google-maps-search
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Google SERP Maps Search API?

Call GET /api/v1/google/maps/search for Google SERP Maps Search through Just Serp API with query. It is an AI Agent Skill for Claude Code / OpenClaw, with 29 downloads so far.

How do I install Google SERP Maps Search API?

Run "/install justserpapi-google-maps-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google SERP Maps Search API free?

Yes, Google SERP Maps Search API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Google SERP Maps Search API support?

Google SERP Maps Search API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Google SERP Maps Search API?

It is built and maintained by justserpapi (@justserpapi); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments