Planned — not available yet. The Prospect Cheap API is being built. This page shows how the endpoint will work so you can plan your integration; the details may change before launch. Until then, use the GMaps Scraper in the dashboard.
Starts a Google Maps search. Returns the new list right away with status running; poll Search Status until it is completed.
Request
curl -X POST https://prospectcheap.com/api/v1/searches \
-H "Content-Type: application/json" \
-H "x-api-key: pc_your_key" \
-d '{"niche": "Plumber", "location": "Texas City, Texas", "country": "US", "max_results": 120, "find_emails": true}'Body
| Field | Type | Description |
|---|---|---|
niche | string, required | The kind of business, e.g. "Dentist". |
location | string, required | City, region or area, e.g. "Austin, Texas". |
country | string, required | Two-letter country code, e.g. "US". |
max_results | integer | 1–500. Default 120. |
find_emails | boolean | Visit each website to collect emails. Default true. |
language | string | Google Maps language, e.g. "en". Default "en". |
Response
{
"list": {
"id": "460b081d-cd98-4ec8-bacc-c50d5e003c71",
"niche": "Plumber",
"location": "Texas City, Texas",
"country_code": "US",
"status": "running",
"result_count": 0,
"created_at": "2026-10-21T13:36:00Z"
}
}