Google Maps

Google Maps Business Search API

Local businesses from a Maps search — name, address, phone, website, rating, hours, place id.

Search Google Maps for a keyword and get up to 100 businesses. q is required (min 2 characters). Pass location as a place name — Austin, TX, Istanbul, Turkey, Paris, France, Brooklyn, NY, or a country such as Germany — or omit it and use locationCode (default 2840, the United States). The response echoes the matched place name and its locationCode. A city name shared by several places (Paris, London) returns 400 with suggestions and costs nothing; add the region or country. language defaults to en. limit is 1–100 and is not a page you can walk: there is no nextCursor. A successful call costs 2 credits even when businesses is empty, because the lookup still ran. Failures cost 0. phone, website, rating, and reviewCount are null when Maps does not publish them — null is not zero. hoursStatus is Maps' own open/closed label (for example open or close), not a boolean we invented. image URLs are hosted by Google and can expire; there is no expiresAt. Ads and other non-business rows are left out and counted in omittedCount. This endpoint does not return owner emails. cache defaults to false. cache=true reuses a 24 hour response, and cache hits are free. The sample is one live listing captured on 10 October 2026, with every field Maps published on that row filled in. Other listings still leave unpublished fields null.

Docs: https://captapi.com/apis/google-maps-business-search

get/v1/google/business-search

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/google/business-search
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

qstring required

Keyword, for example plumber or coffee. Min 2 characters.

locationstring

Place name: City, Country or City, Region, Country — for example Austin, TX, Istanbul, Turkey, Paris, France, or a country such as Germany. Case, accents, US state codes, and country aliases (USA, UK, Turkey) are handled. A city name shared by several places (Paris) returns 400 with suggestions. When set, the locationCode parameter is ignored.

locationCodeinteger

Numeric place code, used only when location is omitted. Default 2840 (United States).

languagestring

Language code, for example en. Default en.

limitinteger

Max businesses to return (default 20, max 100). Not a page cursor — there is no next page. Flat 2 credits on every successful call, including zero businesses.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.