# Google Maps Review Scraper API by Bolt Scraper

> Programmatic API for Google Maps customer review extraction. Extract 100% of reviews, star ratings, reviewer profile links, photos, and owner replies in clean JSON without Google OAuth.

**URL:** https://boltscraper.com/api/google-reviews-api/  
**Online Platform:** https://app.boltscraper.com  
**Interactive Docs:** https://docs.boltscraper.com/?topic=reviews-search  
**Base URL:** `https://boltscraper.com/api/v1`  
**Authentication:** `Authorization: Bearer bs_YOUR_API_KEY`  

---

## What it does

The Bolt Scraper Google Maps Review Scraper API enables programmatic extraction of public customer feedback and ratings from any Google Maps listing:

1. **Synchronous Real-Time Reviews (`POST /v1/reviews/search`)**: Extract paginated reviews in real time (~1–3s latency) using cursor-based `next_page_token` pagination.
2. **Background Batch Review Jobs (`POST /v1/reviews/jobs`)**: Submit places to extract all historical reviews (up to 25,000+ reviews per place) with webhook notification and CSV export.

---

## Key Advantages

* **Bypass Official 5-Review Limitation**: The official Google Places API restricts developers to only 5 "most helpful" reviews. Bolt Scraper unlocks 100% of public reviews for complete sentiment analysis, reputation monitoring, and market research.
* **Zero OAuth Requirements**: Query reviews for any business, competitor, or local franchise without business verification, Google Cloud Console billing, or OAuth tokens.
* **Owner Responses & Metadata**: Captures business owner replies, response timestamps, translated review text, photo attachments, and reviewer profile URLs.

---

## Endpoints

### 1. Real-Time Review Search
`POST https://boltscraper.com/api/v1/reviews/search`

#### Request Payload
```json
{
  "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "sort_by": "newest",
  "limit": 20
}
```

#### Response (HTTP 200 OK)
```json
{
  "success": true,
  "status": "success",
  "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "total_reviews": 12480,
  "average_rating": 4.7,
  "next_page_token": "CAESBkVnb2JhalE...",
  "reviews": [
    {
      "review_id": "ChZDSUhNMG9nS0VJQ0FnSUN6MUl2S1R3EAE",
      "author_name": "Sarah Jenkins",
      "author_url": "https://www.google.com/maps/contrib/1049281928472918",
      "author_photo_url": "https://lh3.googleusercontent.com/a-/ALV-Uj...",
      "rating": 5,
      "text": "Incredible service, exquisite coffee, and an unmatched atmosphere overlooking the market. Highly recommended!",
      "relative_publish_time_description": "2 days ago",
      "publish_timestamp": 1729482000,
      "likes_count": 4,
      "photos": [
        "https://lh5.googleusercontent.com/p/AF1QipM..."
      ],
      "owner_response": {
        "text": "Thank you so much Sarah! We look forward to welcoming you back on your next visit.",
        "publish_timestamp": 1729501200
      }
    }
  ]
}
```

---

### 2. Batch Review Extraction
`POST https://boltscraper.com/api/v1/jobs`

```json
{
  "service": "google_reviews",
  "place_ids": ["ChIJN1t_tDeuEmsRUsoyG83frY4", "ChIJbT0mY5JqkFQRzVq7g"],
  "max_reviews_per_place": 5000,
  "webhook_url": "https://your-crm.com/api/webhook"
}
```