# Contributor Reviews

Fetch all reviews written by a single Google Maps contributor (Local Guide): profile header with Local Guide level and points, contribution counts, and the review feed with place detail, rating, date, snippet, photos and owner replies. The numeric contributor ID is the author ID returned as author_id by the Google Maps reviews endpoints.

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

## 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 |
| --- | --- | --- | --- |
| `contributor_id` | string | Yes | The numeric Google Maps contributor ID, taken from the author ID of any review. |
| `hl` | string | No | Interface language for the upstream payload. |
| `gl` | string | No | Country/region code for the upstream payload. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/maps/contributor-reviews?contributor_id=114427132849405397807&hl=en&gl=us"
```

## Example response

```json
{
    "contributor": {
        "contributor_id": "114427132849405397807",
        "name": "Raafe Purnsley",
        "thumbnail": "https://lh3.googleusercontent.com/a-/ALV-UjXNG_03CfdInQhDO-JDM3HIAhggw6HJTR2igs8WY0wZ8jhwAmk=s120-c-rp-mo-ba12-br100",
        "local_guide_level": 4,
        "points": 323,
        "level_goal": "177 points away from Level 5",
        "photo_count": 4
    },
    "contributions": {
        "reviews": 13,
        "ratings": 0,
        "photos": 4,
        "answers": 12,
        "places_added": 0,
        "edits": 0,
        "videos": 0,
        "qa": 0,
        "roads_added": 0,
        "captions": 0,
        "reported_incorrect": 0,
        "trip_feedback": 0,
        "incident_reports": 1
    },
    "reviews": [
        {
            "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t3eU9EUkJTRkE0WmpKWldFaDNRMmxxWkRJdE5rRRAB",
            "place_info": {
                "place_id": "ChIJESlKXfbprIkRj4IVDwHKW-U",
                "data_id": "0x89ace9f65d4a2911:0xe55bca010f15828f",
                "title": "Hyper Kidz Durham",
                "address": "105 W North Carolina 54 suite 237B, Durham, NC 27713",
                "gps": {
                    "latitude": 35.9100245,
                    "longitude": -78.9384918
                },
                "type": "Indoor playground",
                "type_id": "indoor_playground",
                "rating": 4.9,
                "review_count": 3594,
                "google_mid": "/g/11wv44v3zt"
            },
            "rating": 5,
            "snippet": "This place is an oasis for a world not designed for kids. When the heat index is too high and the parks hare far and few between (have lead in the soil) or don\u2019t have many amenities. Also JAYLA was amazing. Quick, knowledgeable, laughed at all my bad jokes.",
            "language": "en",
            "date": {
                "timestamp": 1782926184747,
                "relative": "3 months ago"
            },
            "images": [],
            "owner_response": {
                "text": "Dear Raafe,\\n\\nThank you so much for your thoughtful review! It means a lot to hear that HyperKidz has become a fun, comfortable place for families to enjoy, especially when outdoor options aren\u2019t ideal.",
                "language": "en",
                "url": "https://business.google.com/local/business/11760901612531927006/customers/reviews/reply?p=CkRDaTlEUVVsUlFVTnZaRU5vZEhsalJqbHZUMnQzZVU5RVVrSlRSa0UwV21wS1dsZEZhRE5STW14eFdrUkpkRTVyUlJBQhAA"
            }
        }
    ],
    "pagination": {
        "has_more": false,
        "next_page_token": null,
        "reviews_declared": 13,
        "reviews_returned": 13,
        "page_size": 100
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The contributor_id, hl or gl parameter failed validation before the upstream request ran. |
| 503 | Contributor Reviews 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)