When should an agent use the Google Maps business search node?

A task needs real local businesses, such as dentists in Leeds or coffee near Austin. It is not meant for reading reviews in depth (use the Google reviews node) or looking up private people. A call usually takes about 16 seconds.

What does the Google Maps business search node return?

Find 10 local businesses on Google Maps for any search and place: name, category, address, phone, website, rating, review count and opening hours as JSON. Each call returns 10 places: name, category, address, phone, website, rating, review count, coordinates, opening hours and a Maps link.

How much does one call cost?

$0.042 in USDC on Base per search (up to 10 businesses) (one call = up to 10 businesses), charged only when it succeeds. No sign-up, subscription or API key.

What happens if the call fails?

You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.

How does an AI agent pay?

With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.

Can I use an API key instead?

Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.

Illustration: a folded map with pins and a small shopfront under the largest pin

Google Maps business search

Find 10 local businesses on Google Maps for any search and place: name, category, address, phone, website, rating, review count and opening hours as JSON.

POST /api/v1/nodes/maps-business-search

Price

$0.042

per search (up to 10 businesses)

One call gets you up to 10 businesses. You only pay when it works: if a call fails, it costs nothing.

Use it from your AI assistant

Paste this once into Claude Code, Cursor or Codex. After that, just ask, for example: “find 10 coffee shops in Lisbon with their reviews”. Your assistant finds this node and pays for it by itself.

connect TollNode (one time)

npx agentcash add https://tollnode.com

For developers: call it directly

terminal

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/maps-business-search -m POST -b '{"query":"coffee shop","location":"Austin, Texas, USA"}'

Is this the right node?

Use it when: A task needs real local businesses, such as dentists in Leeds or coffee near Austin.
Not for: Reading reviews in depth (use the Google reviews node) or looking up private people.
You get: 10 places: name, category, address, phone, website, rating, review count, coordinates, opening hours and a Maps link.
Typical time: About 16 seconds per call

How it works

Your agent pays for itself

Explained in 5 minutes →

1Needs something
2Finds it on TollNode
3Pays a few cents
4Gets the result

Two ways to use Google Maps business search

Way 1 · Pay per call (x402)

For AI agents, no sign-up

Your agent sends the request, gets a 402 with the exact price ($0.042 per search (up to 10 businesses)), signs a USDC payment on Base and retries. Nothing is collected unless the call succeeds.

add TollNode to Claude Code, Cursor or Codex (once)

npx agentcash add https://tollnode.com

or call it directly

npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/maps-business-search -m POST -b '{"query":"coffee shop","location":"Austin, Texas, USA"}'

Way 2 · Account + API key

For apps and teams

Create a free account, load a balance with USDC on Base, create an API key and call any node. Same prices; each successful call is deducted from your balance.

curl

curl -X POST https://tollnode.com/api/v1/nodes/maps-business-search \
  -H "Authorization: Bearer $TOLLNODE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"coffee shop","location":"Austin, Texas, USA"}'

Step-by-step, with code in JavaScript and Python: full guide for Google Maps business search.

Input

Field	Type	Notes
query*	string	What to look for, e.g. coffee shop, dentist, plumber
location*	string	City, area or address, e.g. Austin, Texas, USA

Example response

{
  "results": [
    {
      "cid": "14523653177900299807",
      "url": "https://www.google.com/maps/search/?api=1&query=Cure%20Bakery%20Coffee&query_place_id=ChIJ1XA2XsozW4YRH3a4nZ1hjsk",
      "city": "Austin",
      "menu": null,
      "rank": 5,
      "floor": null,
      "kgmid": "/g/11nxt51vdd",
      "phone": "(512) 428-4007",
      "price": null,
      "state": "Texas",
      "title": "Cure Bakery Coffee",
      "street": "13642 Research Blvd",
      "address": "13642 Research Blvd, Austin, TX 78750",
      "language": "en",
      "location": {
        "lat": 30.4542178,
        "lng": -97.7926433
      },
      "plusCode": null,
      "subTitle": null,
      "locatedIn": null,
      "scrapedAt": "2026-11-08T18:48:08.150Z",
      "hotelStars": null,
      "postalCode": "78750",
      "totalScore": 4.8,
      "checkInDate": null,
      "countryCode": "US",
      "description": null,
      "imagesCount": 321,
      "categoryName": "Bakery",
      "checkOutDate": null,
      "neighborhood": "Anderson Mill",
      "reviewsCount": 451,
      "searchString": "coffee shop",
      "servicesLink": null,
      "googleFoodUrl": null,
      "isAdvertisement": false,
      "reserveTableUrl": null,
      "hotelDescription": null,
      "ownerDescription": null,
      "phoneUnformatted": "+15124284007",
      "businessProfileId": "6152699644692407864",
      "claimThisBusiness": false,
      "permanentlyClosed": false,
      "temporarilyClosed": false,
      "wasOpenAtScrapeTime": true,
      "popularTimesLiveText": null,
      "popularTimesLivePercent": null
    }
  ]
}

FAQ

When should an agent use the Google Maps business search node?: A task needs real local businesses, such as dentists in Leeds or coffee near Austin. It is not meant for reading reviews in depth (use the Google reviews node) or looking up private people. A call usually takes about 16 seconds.
What does the Google Maps business search node return?: Find 10 local businesses on Google Maps for any search and place: name, category, address, phone, website, rating, review count and opening hours as JSON. Each call returns 10 places: name, category, address, phone, website, rating, review count, coordinates, opening hours and a Maps link.
How much does one call cost?: $0.042 in USDC on Base per search (up to 10 businesses) (one call = up to 10 businesses), charged only when it succeeds. No sign-up, subscription or API key.
What happens if the call fails?: You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
How does an AI agent pay?: With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.
Can I use an API key instead?: Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.