# Google Search Business Search API (https://www.socialcrawl.dev/platforms/google/business-search)

> Returns the Google Maps businesses for a keyword or category in a place, in Google's own order: name, cid, place_id, address, phone, website, category and additional categories, star rating and review count, coordinates, claimed status and opening hours. `place.id` is the cid, so any row chains into GET /v1/google/business/info?cid= or /v1/google/business/extended-reviews?cid=. `place.ext` adds `place_id`, `maps_url`, `domain`, `rank`, `city`, `postal_code`, `region`, `country_code`, `hours` and `status`. Give the place as `location` ("Milano, Italy", a country, or a full "City,Region,Country" name such as "Milan,Lombardy,Italy") or as `lat` + `lng` (with an optional `zoom`); sending neither, or both, is a free 400. Sponsored listings are left out. A flat 5 credits for up to 100 places; a search with no results returns an empty list and is not billed.

TL;DR: `GET /v1/google/business/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | What to look for, as you would type it into Google Maps: a category or trade ('dentista', 'ristorante', 'commercialista') or a business name. Use the local language for local results. |
| `location` | no | Where to search: 'City, Country' (e.g. 'Milano, Italy'), a country name or ISO code ('Italy', 'IT'), or a full City,Region,Country name ('Milan,Lombardy,Italy'). Required unless lat and lng are sent. |
| `lat` | no | Latitude of the search centre (-90 to 90). Send with lng instead of location. |
| `lng` | no | Longitude of the search centre (-180 to 180). Send with lat instead of location. |
| `zoom` | no | Google Maps zoom level around lat/lng, 3 (continent) to 21 (street). Defaults to 14, about a city district. Only with lat/lng. |
| `language` | no | Language code for the results ('it', 'en', 'de'). Defaults to the main language of the country in location ('it' for Italy), or 'en' for coordinates. |
| `limit` | no | How many places to return, 1-100 (default 20). The price is the same at any limit. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/google/business/search" \
  --data-urlencode "query=dentista" \
  --data-urlencode "location=Milano, Italy" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Google Search API: https://www.socialcrawl.dev/platforms/google

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing