# Enrich business

Find a business on Google Maps by name and optional city/state, returning the best match with available contact, address, rating, category, and coordinate fields.

- Platform: [Google Maps](https://docs.upscrape.com/docs/platforms/googlemaps)
- Capability ID: `googlemaps.enrich`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "business_name": "Apple Inc",
    "city": "Cupertino",
    "state": "CA"
  },
  "capability": "googlemaps.enrich"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `business_name` | `string` | Yes | Business name to search for. |
| `city` | `string` | No | City name for location bias. |
| `country` | `string` | No | Two-letter country code (default 'us'). |
| `lang` | `string` | No | Language code such as 'en' or 'en-US' (default 'en'). |
| `state` | `string` | No | State or region for location bias. |

### Example input

```json
{
  "business_name": "Apple Inc",
  "city": "Cupertino",
  "state": "CA"
}
```

## Response

Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This redacted fixture is an example, not a fixed response schema.

```json
{
  "address": "Apple Park, One Apple Park Way, Cupertino, CA 95014",
  "cid": "4255201883087866096",
  "confidence": "high",
  "feature_id": "0x808fb596e9e188fd:0x3b0d8391510688f0",
  "lat": 37.334643799999995,
  "latency_ms": 1990,
  "lng": -122.008972,
  "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ_Yjh6Za1j4AR8IgGUZGDDTs",
  "name": "Apple Park",
  "phone": "[redacted:phone]",
  "place_id": "ChIJ_Yjh6Za1j4AR8IgGUZGDDTs",
  "rating": 4.3,
  "source": "google_maps",
  "types": [
    "Electronics store",
    "Computer repair service",
    "Mobile phone repair shop"
  ],
  "website": "http://www.apple.com/"
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `address` | `string` | Apple Park, One Apple Park Way, Cupertino, CA 95014 |
| `cid` | `string` | 4255201883087866096 |
| `confidence` | `string` | high |
| `feature_id` | `string` | 0x808fb596e9e188fd:0x3b0d8391510688f0 |
| `lat` | `number` | 37.334643799999995 |
| `latency_ms` | `integer` | 1990 |
| `lng` | `number` | -122.008972 |
| `maps_url` | `string` | https://www.google.com/maps/place/?q=place_id:ChIJ_Yjh6Za1j4AR8IgGUZGDD… |
| `name` | `string` | Apple Park |
| `phone` | `string` | [redacted:phone] |
| `place_id` | `string` | ChIJ_Yjh6Za1j4AR8IgGUZGDDTs |
| `rating` | `number` | 4.3 |
| `source` | `string` | google_maps |
| `types` | `array` | 3 items |
| `types` | `array` | 3 items |
| `website` | `string` | http://www.apple.com/ |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)