POST /api/gmaps/lists — local businesses from Google Maps with websites, emails, owner names, phones (with line type), socials, ratings and Maps rank.
Single search
| Field | Type | Notes |
|---|---|---|
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 code: US, CA, GB, AU, NZ, IE, DE, FR, ES, IT, NL, BE, CH, AT, SE, NO, DK, FI, PT, PL, CZ, GR, AE, SA, QA, IN, BD, PK, SG, MY, PH, ID, TH, JP, KR, ZA, NG, KE, EG, MX, BR, AR, CL, CO. |
maxResults | integer | 1–500. Default 120. |
language | string | Google Maps language: en, es, fr, de, it, pt, nl, sv, pl, ar, hi, bn, ja, ko. Default en. |
curl -X POST https://prospectcheap.com/api/gmaps/lists \
-H "Authorization: Bearer pc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"niche":"Dentist","location":"Austin, Texas","country":"US","maxResults":120}'
Bulk keywords
Send keywords instead of niche to run up to 50 searches in one list. maxResults then applies to each keyword. With a shared location each keyword is searched there; without one, put the place in the keyword ("dentist in Austin, TX").
| Field | Type | Notes |
|---|---|---|
keywords | string[] or string | Up to 50 (array, or one per line). |
location | string | Optional shared location. |
country | string, required | As above. |
maxResults | integer | 1–500 per keyword. |
curl -X POST https://prospectcheap.com/api/gmaps/lists \
-H "Authorization: Bearer pc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"keywords":["dentist","cosmetic dentist","orthodontist"],"location":"Austin, Texas","country":"US","maxResults":60}'
Then
The response has list.id. Poll GET /api/gmaps/lists/{id} until list.status is completed (or failed); the results are under leads. See Search Status, Filter & Paginate and Export CSV.
Credits: one per result found. The most the search could cost is reserved when it starts; what isn't used comes back when it finishes.
