[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Google Maps business search](https://spiral.ai/integrations/codex/google-maps-business-search)

# How to Use Google Maps business search in Codex

Returns 20 business listings per page with addresses, coordinates, ratings, review counts, and business identifiers. Use it to find locations before examining their reviews or planning a visit.

|  |  |
| --- | --- |
| Model | Google Maps business search |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.017459 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Google Maps business search in Codex

- Use Google Maps business search to find coffee shops in downtown Seattle and add a comparison table of names, addresses, ratings, and review counts to my project's research report.
- Use Google Maps business search for commercial printers in Boston and populate my project's vendor comparison table with business names, websites, phone numbers, and ratings.
- Scrape https://example.com/pricing with Google Maps business search and turn it into a comparison table. Save the result in ./assets.
- Crawl the docs at https://docs.example.com with Google Maps business search and summarize each section.
- Pull the latest posts from this blog with Google Maps business search and list their titles and dates.

## How to set up Google Maps business search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Google Maps business search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "firecrawl-maps/businesses/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Google Maps business search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Google Maps business search tools and prices

- [Maps · Search](https://spiral.ai/tools/alexandria/firecrawl-maps/businesses/search) (Alexandria): $0.017459 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | The next_cursor from a previous search with the same query, latitude and longitude. Omit for the first page. Pattern: ^[0-9]{1,4}$. |
| country |  | us | Two-letter country code uses to rank and localize results (gl), e.g. ca, ro, by. Default us. Pattern: ^[A-Za-z]{2}$. |
| language |  | en | Language of place names, addresses and labels (hl), e.g. en, ro, ru, pt-BR. Default en. Pattern: ^[a-z]{2,3}(-[A-Za-z]{2,4})?$. |
| latitude | -90 to 90 | — | Optional viewport centre; provide with longitude. Defaults to the contiguous US centroid; the query text carries the location. |
| longitude | -180 to 180 | — | longitude |

## What can you do with Google Maps business search in Codex?

Build a local business comparison report with listing details, customer feedback, and travel estimates. A coding agent can turn Maps results into tables in your project and label the 60-review trend sample clearly.

### Choose a restaurant and plan the trip

Find restaurants near San Francisco's Ferry Building, compare recent feedback and monthly rating patterns, then check travel time to the shortlist.

### Compare hotels near a conference

Find hotels near the Austin Convention Center, examine service complaints and recent rating patterns, and compare routes to the venue.

### Prepare competitor field visits

Find competing coffee shops in downtown Seattle, identify recurring customer complaints and recent rating patterns, and plan travel between selected locations.

### Screen venues for a team event

Find bowling alleys in Chicago, compare group-service feedback and monthly rating patterns, and estimate travel from McCormick Place.

### Prepare a restaurant operations review

Resolve the correct restaurant location, summarize recurring service issues and owner replies, and examine the monthly pattern in its newest 60 reviews.

### Compare local business vendors

Find commercial printing businesses in Boston and compare customer comments about turnaround and service with their recent monthly rating patterns.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Google Maps business search in other agents

- [Amp](https://spiral.ai/integrations/amp/google-maps-business-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/google-maps-business-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/google-maps-business-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/google-maps-business-search)
- [Cline](https://spiral.ai/integrations/cline/google-maps-business-search)
- [Cursor](https://spiral.ai/integrations/cursor/google-maps-business-search)
- [Devin](https://spiral.ai/integrations/devin/google-maps-business-search)
- [dots](https://spiral.ai/integrations/dots/google-maps-business-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/google-maps-business-search)
- [Gemini](https://spiral.ai/integrations/gemini/google-maps-business-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/google-maps-business-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/google-maps-business-search)
- [goose](https://spiral.ai/integrations/goose/google-maps-business-search)
- [Grok](https://spiral.ai/integrations/grok/google-maps-business-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/google-maps-business-search)
- [Hermes](https://spiral.ai/integrations/hermes/google-maps-business-search)
- [Instinct](https://spiral.ai/integrations/instinct/google-maps-business-search)
- [Manus](https://spiral.ai/integrations/manus/google-maps-business-search)
- [Muse](https://spiral.ai/integrations/muse/google-maps-business-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/google-maps-business-search)
- [n8n](https://spiral.ai/integrations/n8n/google-maps-business-search)
- [Notion](https://spiral.ai/integrations/notion/google-maps-business-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/google-maps-business-search)
- [opencode](https://spiral.ai/integrations/opencode/google-maps-business-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/google-maps-business-search)
- [Raycast](https://spiral.ai/integrations/raycast/google-maps-business-search)
- [VS Code](https://spiral.ai/integrations/vscode/google-maps-business-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/google-maps-business-search)
- [Zapier](https://spiral.ai/integrations/zapier/google-maps-business-search)

## More Codex guides

- [Google Maps business reviews](https://spiral.ai/integrations/codex/google-maps-business-reviews)
- [Google Maps directions](https://spiral.ai/integrations/codex/google-maps-directions)
- [Google Maps business rating trend](https://spiral.ai/integrations/codex/google-maps-business-rating-trend)
- [Hipcamp blocked-date calendar](https://spiral.ai/integrations/codex/hipcamp-blocked-date-calendar)
- [Google Flights fare search](https://spiral.ai/integrations/codex/google-flights-fare-search)
- [Hipcamp campsite reviews](https://spiral.ai/integrations/codex/hipcamp-campsite-reviews)

## Questions about Google Maps business search in Codex

**Can Codex use Google Maps business search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Google Maps business search like any built-in tool.

**How much does Google Maps business search cost in Codex?**

$0.017459 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Google Maps business search in Codex?**

No. Spiral runs Google Maps business search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Google Maps business search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Google Maps business search runs?**

Google Maps business search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Where does Google Maps get business information?**

Google combines business websites, licensed data, contributions from users and business owners, and its own interactions with businesses. A listing can contain information its owner did not supply.

**How quickly does a business's overall rating update?**

Google says a new review can take up to two weeks to affect the displayed overall score. That score averages all published Google ratings, while the monthly trend here uses the newest 60 reviews.

**Does a business search cover every matching business?**

It returns 20 listings per page. Google's local results are ranked by relevance, distance, and popularity, so a first page should not be treated as a complete business count.

**Why can public reviews be missing or delayed?**

Google checks reviews for policy compliance, which can delay publication by a few days. It also removes reviews for violations such as spam or inappropriate content.

**Are transit directions available in every city?**

No. Google says a local transit agency must add its route information before transit directions can be available for that city.

