# Scraping APIs & Webhooks by Bolt Scraper

> Programmatic lead extraction REST API for Google Maps, Customer Reviews, and Company Websites. Query synchronously for instant results (~2-4s) or launch background batch jobs with automated HMAC-SHA256 signed webhooks.

**URL:** https://boltscraper.com/api/  
**Online Platform:** https://app.boltscraper.com  
**Interactive API Docs:** https://docs.boltscraper.com  
**Base URL:** `https://boltscraper.com/api/v1`  
**Authentication:** Bearer Token (`Authorization: Bearer bs_YOUR_API_KEY`)  

---

## Overview

Bolt Scraper provides high-performance, developer-friendly REST endpoints to programmatically search, scrape, and enrich leads at scale:

1. **Google Maps Scraper API**: Search local businesses in real-time or submit bulk multi-keyword scraping jobs with residential proxy rotation, website email crawling, and mobile vs. landline phone classification.
2. **Google Maps Review Scraper API**: Bypass Google Places API 5-review limits. Extract 100% of reviews, star ratings, reviewer profile links, photos, and owner replies in clean JSON without Google OAuth.
3. **Website Scraper API**: Real-time domain contact enrichment. Deeply crawl company websites to extract direct corporate emails, phone numbers, and 7+ social profiles with automated subpage discovery and 0-credit refund fallback on dead sites.

---

## Core API Endpoints

| Method | Endpoint | Description | Mode | Typical Latency |
|:---|:---|:---|:---|:---|
| `POST` | `/v1/maps/search` | Instant Google Maps search (~20 places per query) | Synchronous | ~2–4 seconds |
| `POST` | `/v1/maps/jobs` | Distributed background batch scraping across multiple keywords | Asynchronous | Cloud Batch |
| `GET` | `/v1/maps/jobs/{id}` | Inspect batch job status, progress counters, and execution state | Polling / Status | <100ms |
| `GET` | `/v1/maps/jobs/{id}/download` | Download consolidated CSV export of leads and contacts | Download | <200ms |
| `POST` | `/v1/reviews/search` | Instant customer reviews extraction without Google OAuth | Synchronous | ~1–3 seconds |
| `POST` | `/v1/reviews/jobs` | Background batch job for full historical reviews (up to 25k+) | Asynchronous | Cloud Batch |
| `GET` | `/v1/reviews/jobs/{id}` | Check execution progress and review counts for an active job | Polling / Status | <100ms |
| `GET` | `/v1/reviews/jobs/{id}/download` | Download consolidated CSV export of reviews and owner replies | Download | <200ms |
| `POST` | `/v1/website/scrape` | Instant domain email, phone, and social media extraction | Synchronous | ~1–3 seconds |
| `POST` | `/v1/website/jobs` | Bulk domain enrichment across thousands of company websites | Asynchronous | Cloud Batch |
| `GET` | `/v1/website/jobs/{id}` | Inspect status, count of resolved domains, and diagnostics | Polling / Status | <100ms |
| `GET` | `/v1/website/jobs/{id}/download` | Download verified CSV with enriched corporate emails and socials | Download | <200ms |

---

## Authentication & Headers

Authenticate every request by passing your API key in the `Authorization` header:

```bash
Authorization: Bearer bs_live_your_api_key_here
Content-Type: application/json
```

Generate and rotate your API keys anytime in the **Bolt Scraper Portal > Integrations** tab.

---

## Credit Model

* **Unified Balance**: 1 credit = 1 extracted lead or review. Credits are shared seamlessly across API, Cloud Portal, and Extensions.
* **Free Forever Plan**: 1,000 free credits renewed monthly.
* **Zero Failure Penalty**: If a query returns 0 results or a domain is dead/unreachable, 0 credits are deducted (100% refund).

---

## Webhooks Integration

Batch jobs support automated webhook delivery upon completion. Specify `webhook_url` when creating a batch job:

```json
{
  "service": "google_maps",
  "queries": ["HVAC contractors in Dallas TX", "Plumbers in Fort Worth TX"],
  "extract_emails": true,
  "webhook_url": "https://your-crm.com/api/bolt-webhook"
}
```

Every webhook includes an `X-Bolt-Signature` header calculated using `HMAC-SHA256` with your webhook secret for cryptographic verification.