Business lists

Businesses of one kind in a city, from Google Maps, with phone and website.

Your agent lists the businesses of one kind in a city, like dentists in Berlin, best rated first. Each one comes with its phone number and website. You also see whether the owner claimed the listing and whether it's open now. You can get up to 1,000 businesses in one request.

Connect your agent Full reference

Returns: JSON result
REST endpoint: POST /v1/business/list
Over MCP: Call chab_operation_start with "business.list"

What you get

Example request

{  "category": "dentist",  "city": "Berlin",  "location": {    "country": "DE"  },  "sort": "rating",  "limit": 20}

Example result

{    "category": "dentist",    "city": "Berlin",    "location": {        "country": "DE"    },    "sort": "rating",    "total": 2814,    "businesses": [        {            "name": "Zahnarztpraxis Wakim",            "category": "Dentist",            "address": "Berliner Allee 82, 13088 Berlin",            "phone": "+49309246064",            "website": "http://www.zahnarztweissensee.de/",            "rating": 5,            "ratings": 8,            "claimed": true,            "open_now": false,            "maps_url": "https://www.google.com/maps?cid=1001575581903926393&hl=en&gl=DE",            "latitude": 52.556,            "longitude": 13.458        }    ],    "fetched_at": "2026-11-13T12:00:00+00:00"}

Inputs

Field	Type	Details
`category`required	string	The kind of business as Google names it, in English: dentist, italian_restaurant, plumber, hotel. Spaces work as well as underscores.Up to 100 characters
`city`required	string	The city, as written in its country, for example Berlin, München or New York.Up to 120 characters
`location`required	object	Country (two letters) of the city.
`location.country`required	string	No extra rules.
`sort`	string	rating: best rated first. reviews: most reviewed first.One of rating, reviews. Default "rating"
`limit`	integer	Up to 1,000 businesses.Default 20. Min 1 max 1000

How to call it

AI apps use it through hosted MCP. Coding agents can also use the CLI, and your own code can call the API. Each call starts a job, and your agent picks up the result when it is ready.

curl -X POST https://www.chab.ai/v1/business/list \  -H "Authorization: Bearer CHAB_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: business-list-001" \  -d '{"category":"dentist","city":"Berlin","location":{"country":"DE"},"sort":"rating","limit":20}'

Business lists result

{    "category": "dentist",    "city": "Berlin",    "location": {        "country": "DE"    },    "sort": "rating",    "total": 2814,    "businesses": [        {            "name": "Zahnarztpraxis Wakim",            "category": "Dentist",            "address": "Berliner Allee 82, 13088 Berlin",            "phone": "+49309246064",            "website": "http://www.zahnarztweissensee.de/",            "rating": 5,            "ratings": 8,            "claimed": true,            "open_now": false,            "maps_url": "https://www.google.com/maps?cid=1001575581903926393&hl=en&gl=DE",            "latitude": 52.556,            "longitude": 13.458        }    ],    "fetched_at": "2026-11-13T12:00:00+00:00"}

Price: From 11 credits, by number of results. See all prices

More in Maps and businesses

Business searchLocal businesses from Google Maps, in any city.Business detailsWhat Google Maps shows about one business.Google reviews of a businessThe Google reviews of a business, with the owner's replies.Trustpilot reviewsThe Trustpilot reviews of a company, with the company's replies.Tripadvisor reviewsThe Tripadvisor reviews of a place, with the stars and the month of the visit.

Want to try Chab with your agent?

Copy the prompt and paste it into your AI. Your agent starts with free credits and doesn't need an account.

See plans