# Business Details

Fetch business details directly from Google Maps including contact info, hours, photos, and the first-party Google reviews summary. The review_count and reviews_per_rating fields exclude syndicated reviews and align with the unique Google Reviews items where is_google_review is true.

- **Documentation:** [https://scrappa.co/docs/google-maps-api/google_business_details](https://scrappa.co/docs/google-maps-api/google_business_details)
- **API group:** Google Maps API
- **Endpoint:** `GET https://scrappa.co/api/maps/business-details`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `business_id` | string | Yes | The unique Google Business ID (format: 0x...:0x...). |
| `hl` | string | No | Language code for results. Default: en |
| `gl` | string | No | Country/region code for geo-filtering. Default: us |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/maps/business-details?business_id=0x8640b88f75b395a3%3A0x8771a1c312c0bd48"
```

## Example response

```json
{
    "status": "OK",
    "business_id": "0x8640b88f75b395a3:0x8771a1c312c0bd48",
    "reviews_removed_due_to_defamation": {
        "message": "In the last year, two to five reviews were removed due to a defamation complaint under local law.",
        "title": "Reviews were removed from this place",
        "help_link": "https://support.google.com/contributionpolicy/answer/16997273",
        "help_link_text": "Learn more about notices for review removals due to defamation complaints in Germany",
        "minimum_removed_review_count": 2,
        "maximum_removed_review_count": 5,
        "summary": "Two to five reviews removed due to defamation complaints.",
        "is_active": true,
        "range_bucket": 2,
        "language": "en",
        "count_text": "two to five"
    },
    "data": [
        {
            "business_id": "0x8640b88f75b395a3:0x8771a1c312c0bd48",
            "name": "Example Business",
            "reviews_removed_due_to_defamation": {
                "message": "In the last year, two to five reviews were removed due to a defamation complaint under local law.",
                "title": "Reviews were removed from this place",
                "help_link": "https://support.google.com/contributionpolicy/answer/16997273",
                "help_link_text": "Learn more about notices for review removals due to defamation complaints in Germany",
                "minimum_removed_review_count": 2,
                "maximum_removed_review_count": 5,
                "summary": "Two to five reviews removed due to defamation complaints.",
                "is_active": true,
                "range_bucket": 2,
                "language": "en",
                "count_text": "two to five"
            }
        }
    ]
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The business_id parameter is required and must be a Google Maps google_id in 0x...:0x... format or a place_id starting with ChIJ. Locale parameters must use valid hl and gl codes. |
| 404 | Business profile not found | Google Maps did not return a business profile for the supplied business_id. This can happen when the ID is stale, the place is no longer public, or the ID points to a profile Google cannot serve in the requested locale. |
| 503 | Business Details temporarily unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)