# Website Scraper API by Bolt Scraper

> Programmatic API for domain contact enrichment. Deeply crawl company websites in real time to extract direct business emails, phone numbers, and social channels—with automatic subpage discovery and 0-credit refund fallback on dead sites.

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

---

## What it does

The Bolt Scraper Website Scraper API transforms raw website URLs and domains into rich, verified corporate contact records:

1. **Synchronous Domain Enrichment (`POST /v1/website/scrape`)**: Instant contact lookup for single domains (~1–3s latency) with multi-page crawling and obfuscation decoding.
2. **Bulk Domain Enrichment Jobs (`POST /v1/website/jobs`)**: Enrich thousands of domains concurrently via background jobs with automated webhook callbacks and CSV export.

---

## Key Capabilities

* **Automated Subpage Discovery**: Crawls beyond the root homepage to automatically discover contact details on `/contact`, `/about`, `/team`, `/help`, `/impressum`, and `/support` up to depth 2.
* **Email Obfuscation Decoding**: Decodes mailto entities, Cloudflare email protection (`/cdn-cgi/l/email-protection`), HTML hex/Unicode encoding, and anti-spam patterns (e.g., `info [at] company [dot] com`).
* **Zero-Credit Refund on Dead Domains**: If a target domain returns HTTP 404, 500, or times out, the API responds with HTTP 502 and immediately refunds 100% of the credit balance.
* **7+ Social Profile Channels**: Extracts direct links for LinkedIn, Facebook, Instagram, Twitter/X, YouTube, TikTok, Pinterest, and GitHub.

---

## Endpoints

### 1. Synchronous Website Contact Scrape
`POST https://boltscraper.com/api/v1/website/scrape`

#### Request Payload
```json
{
  "url": "https://storyville.com",
  "max_subpages": 5,
  "timeout_seconds": 15
}
```

#### Response (HTTP 200 OK)
```json
{
  "success": true,
  "status": "success",
  "domain": "storyville.com",
  "url": "https://storyville.com",
  "data": {
    "emails": [
      "support@storyville.com",
      "wholesale@storyville.com"
    ],
    "phones": [
      "+1 206-780-5777"
    ],
    "social_links": {
      "facebook": "https://facebook.com/storyvillecoffee",
      "instagram": "https://instagram.com/storyville",
      "twitter": "https://twitter.com/storyville",
      "linkedin": "https://linkedin.com/company/storyville-coffee-company",
      "youtube": "https://youtube.com/@storyvillecoffee"
    },
    "subpages_crawled": [
      "https://storyville.com/",
      "https://storyville.com/pages/contact",
      "https://storyville.com/pages/about-us"
    ],
    "scan_duration_ms": 1420
  }
}
```

---

### 2. Bulk Domain Enrichment Batch Job
`POST https://boltscraper.com/api/v1/jobs`

```json
{
  "service": "website_enrichment",
  "domains": [
    "https://stripe.com",
    "https://shopify.com",
    "https://notion.so"
  ],
  "webhook_url": "https://your-crm.com/api/webhook"
}
```
