Maps businesses

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

POST /data/maps/search returns businesses from a Google Maps search.

Try it in the Console

Try this API in the playground, no code needed.

Quick start

curl -X POST https://api.notte.cc/data/maps/search \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search": "coffee shops in Brooklyn, NY"}'

{
  "results": [
    {
      "place_id": "ChIJ2wEUJhtbwokRIm0YqqLWk7o",
      "name": "Casita of Brooklyn",
      "rating": 4.8,
      "number_of_reviews": 0,
      "website": null,
      "google_maps_url": "https://www.google.com/maps/place/...",
      "google_category": ["Coffee shop"],
      "latitude": 40.668,
      "longitude": -73.9878,
      "claimed": true
    }
  ]
}

Parameters

string

What to look for, for example coffee shops in Brooklyn, NY.

string

A Google Maps URL to read instead of running a search.

Send either search or url.

Response fields

Each item in results can include:

Field	Description
`place_id`, `cid`	Google identifiers
`name`, `about`, `google_description`	Name and descriptions
`google_category`	Categories, for example `["Coffee shop"]`
`rating`, `number_of_reviews`, `google_reviews_url`	Reviews
`website`, `google_phone`, `google_maps_url`	Contact and links
`google_hours`	Opening hours
`google_price_range_dollar_sign`	Price level, for example `$$`
`claimed`	Whether the owner claimed the listing
`latitude`, `longitude`	Coordinates
`street_addr`, `city`, `state`, `postal_code`, `country`	Address
`order_online_url`, `google_orders_urls`	Ordering links

Getting Started

Sessions

Authentication

Functions

Data APIs

Anything API

Maps businesses

Try it in the Console

Quick start

Parameters

Response fields

Try it in the Console

​Quick start

​Parameters

​Response fields

Quick start

Parameters

Response fields