Pre-built scrapers
Purpose-built scrapers for the most common lead generation sources. Each returns an array of business listings with normalized fields, no scraping infrastructure required on your end.
All scrapers are available at /v1/scrapers/ and count against your plan's credits like any other metered endpoint (see Pricing). google-maps returns mock data on the Free tier until the live scraper is enabled for your account; yelp, yellow-pages, and directory run live on every tier.
POST /v1/scrapers/google-maps
Search Google Maps for local businesses by keyword and location.
Request
curl -X POST https://api.superscraper.dev/v1/scrapers/google-maps \
-H "x-api-key: ss_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"query": "roofing contractor",
"location": "Denver, CO",
"maxResults": 10
}'Body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | Business type or keyword to search for | |
location | string | No | City, state, or zip code to scope the search | |
maxResults | number | No | 5 | Number of results to return (max 20) |
Response
{
"results": [
{
"name": "Apex Roofing & Restoration",
"address": "1204 S Colorado Blvd, Denver, CO 80222",
"phone": "(303) 555-0142",
"rating": 4.8,
"review_count": 312,
"category": "Roofing contractor",
"hours": "Mon–Fri 7am–6pm, Sat 8am–4pm",
"website": "https://apexroofingdenver.com",
"google_maps_url": "https://maps.google.com/?cid=..."
},
{
"name": "Summit Storm Roofing",
"address": "887 E Evans Ave, Denver, CO 80210",
"phone": "(303) 555-0198",
"rating": 4.6,
"review_count": 189,
"category": "Roofing contractor",
"hours": "Mon–Sat 8am–5pm",
"website": "https://summitstoofing.com",
"google_maps_url": "https://maps.google.com/?cid=..."
}
],
"total": 2,
"query": "roofing contractor",
"location": "Denver, CO"
}POST /v1/scrapers/yelp
Search Yelp for local businesses.
Request
curl -X POST https://api.superscraper.dev/v1/scrapers/yelp \
-H "x-api-key: ss_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"query": "water damage restoration",
"location": "Phoenix, AZ",
"maxResults": 5
}'Body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | Business type or keyword | |
location | string | Yes | City, state, or zip code | |
maxResults | number | No | 5 | Number of results (max 20) |
Response
{
"results": [
{
"name": "Desert Restoration Specialists",
"address": "3400 N Central Ave, Phoenix, AZ 85012",
"phone": "(602) 555-0167",
"rating": 4.7,
"review_count": 88,
"price_range": "$$$",
"categories": ["Water Damage Restoration", "Fire Damage Restoration"],
"is_open_now": true,
"yelp_url": "https://yelp.com/biz/desert-restoration-specialists-phoenix"
}
],
"total": 1,
"query": "water damage restoration",
"location": "Phoenix, AZ"
}POST /v1/scrapers/yellow-pages
Search Yellow Pages for local businesses.
Request
curl -X POST https://api.superscraper.dev/v1/scrapers/yellow-pages \
-H "x-api-key: ss_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"query": "HVAC repair",
"location": "Atlanta, GA",
"maxResults": 10
}'Body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | Business category or keyword | |
location | string | Yes | City, state, or zip code | |
maxResults | number | No | 5 | Number of results (max 20) |
Response
{
"results": [
{
"name": "Atlanta Air Comfort Solutions",
"address": "2210 Peachtree Rd NW, Atlanta, GA 30309",
"phone": "(404) 555-0231",
"rating": 4.4,
"review_count": 97,
"category": "Air Conditioning & Heating",
"website": "https://atlantaaircomfort.com",
"yp_url": "https://www.yellowpages.com/atlanta-ga/mip/atlanta-air-comfort-solutions"
}
],
"total": 1,
"query": "HVAC repair",
"location": "Atlanta, GA"
}POST /v1/scrapers/directory
Batch scrape a list of directory listing URLs, useful for processing a set of Yelp, Angi, HomeAdvisor, or similar profile pages you've already collected.
Accepts up to 500 URLs per request. Runs concurrently to minimize latency.
Request
curl -X POST https://api.superscraper.dev/v1/scrapers/directory \
-H "x-api-key: ss_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.yelp.com/biz/apex-plumbing-austin",
"https://www.angi.com/companylist/us/tx/austin/plumbing.htm",
"https://www.thumbtack.com/tx/austin/plumber/apex-plumbing/service"
],
"concurrency": 5
}'Body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
urls | string[] | Yes | Array of directory listing URLs (max 500) | |
concurrency | number | No | 3 | Parallel scrape concurrency (max 10) |
Response
{
"results": [
{
"url": "https://www.yelp.com/biz/apex-plumbing-austin",
"ok": true,
"listing": {
"name": "Apex Plumbing Austin",
"phone": "(512) 555-0187",
"address": "1402 S 1st St",
"city": "Austin",
"state": "TX",
"zip": "78704",
"rating": 4.8,
"review_count": 214,
"_confidence": 0.91,
"_extraction_method": "json-ld"
}
},
{
"url": "https://www.angi.com/companylist/us/tx/austin/plumbing.htm",
"ok": true,
"listing": {
"name": "Austin Plumbing Pros",
"phone": "(512) 555-0134",
"rating": 4.6,
"review_count": 189,
"_confidence": 0.74,
"_extraction_method": "heuristic"
}
},
{
"url": "https://www.thumbtack.com/tx/austin/plumber/apex-plumbing/service",
"ok": false,
"error": "HTTP 403"
}
],
"total": 3,
"succeeded": 2,
"failed": 1
}