Local Business Database API
Query the local business database via API. Access hundreds of thousands of businesses with emails, phone numbers, ratings, and location data. Requires $649/mo plan.
Included with $649/mo plan
GET /api/v1/database/local-businessesDatabase APIs are included with the $649/mo plan.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | number | Optional | Page number (default: 1)Default: 1Example: 1 |
limit | number | Optional | Results per page (max: 100)Default: 50Example: 100 |
category | string[] | Optional | Filter by business category (multiple allowed)Example: Restaurant |
country | string[] | Optional | Filter by country (multiple allowed)Example: US |
state | string | Optional | Filter by state (partial match)Example: Texas |
city | string | Optional | Filter by city (partial match)Example: Austin |
postalCode | string | Optional | Filter by postal/zip codeExample: 78701 |
minRating | number | Optional | Minimum Google rating (1-5)Example: 4 |
maxRating | number | Optional | Maximum Google rating (1-5)Example: 5 |
minReviews | number | Optional | Minimum number of reviewsExample: 50 |
maxReviews | number | Optional | Maximum number of reviewsExample: 1000 |
hasEmail | boolean | Optional | Only return businesses with email addressesDefault: falseExample: true |
hasPhone | boolean | Optional | Only return businesses with phone numbersDefault: falseExample: true |
hasWebsite | boolean | Optional | Only return businesses with websitesDefault: falseExample: true |
query | string | Optional | Full-text search across business name and descriptionExample: pizza |
Examples
Find restaurants in Austin with 4+ stars
curl "https://app.scrapercity.com/api/v1/database/local-businesses?category=Restaurant&city=Austin&state=Texas&minRating=4&hasEmail=true&limit=100" \ -H "Authorization: Bearer YOUR_API_KEY"
Search for dentists with good reviews
curl "https://app.scrapercity.com/api/v1/database/local-businesses?category=Dentist&minReviews=50&minRating=4&country=US&limit=50" \ -H "Authorization: Bearer YOUR_API_KEY"
Use Cases
- •Build local business outreach lists for agencies
- •Power local SEO and marketing campaigns
- •Enrich your CRM with local business data
- •Find businesses by category and location at scale
Best Practices
- •Use category + location filters for targeted results
- •Rate limit: 100 businesses per request, 100,000 per day
- •Filter by hasEmail=true to only get businesses with contact info
- •Use minRating to target high-quality businesses
- •Requires $649/mo plan - upgrade at /dashboard/billing
- •Daily limit resets at midnight UTC
Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.
Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.