Starts a search on one source. Returns the new list right away with status running; poll Search Status until it is completed.
curl -X POST https://getclient.pro/api/yelp/lists \
-H "Authorization: Bearer gc_live_your_key" \
-H "Content-Type: application/json" \
-d '{ "searchTerms": ["plumbers"], "locations": ["Austin, TX"], "maxPerSearch": 30 }'Sources
| Source | {source} | Results key |
|---|---|---|
| Google Maps | gmaps | leads |
| Yelp | yelp | businesses |
| Yellow Pages | yellowpages | businesses |
| Trustpilot | trustpilot | businesses |
| YouTube | youtube | channels |
| Facebook Ad Library | fbads | pages |
| Product Hunt | producthunt | products |
| TrustMRR | trustmrr | startups |
| Skool | skool | members |
Body examples
| Source | Body |
|---|---|
POST /api/gmaps/lists | { "keywords": ["dentist"], "location": "Austin, Texas", "country": "US", "maxResults": 100 } |
POST /api/yelp/lists | { "searchTerms": ["plumbers"], "locations": ["Austin, TX"], "maxPerSearch": 30 } |
POST /api/yellowpages/lists | { "searchTerms": ["roofing contractors"], "locations": ["Denver, CO"], "maxPerSearch": 30, "sort": "average_rating" } |
POST /api/trustpilot/lists | { "categories": ["plumber"], "filters": { "country": "US", "minTrustScore": "4" }, "maxPerSource": 50 } |
POST /api/youtube/lists | { "mode": "search", "keywords": ["home workout"], "country": "US", "maxResults": 50 } |
POST /api/fbads/lists | { "mode": "search", "keyword": "roof replacement", "country": "US", "maxResults": 100 } |
POST /api/producthunt/lists | { "mode": "search", "keyword": "crm", "maxResults": 50 } |
POST /api/trustmrr/lists | { "maxResults": 100, "filters": { "categories": ["saas"], "minMrr": 5000 } } |
POST /api/skool/lists | { "groups": ["https://www.skool.com/your-community"], "maxResults": 100 } |
- Google Maps and YouTube take up to 50
keywords;maxResultsis then per keyword. - Yelp searches every term in every location;
maxPerSearch(up to 240) applies to each. - Yellow Pages (US only) works the same way, with
maxPerSearchup to 3,000, plus optionalsort,categories,neighborhoods,bbbRatedandopen24h. - Trustpilot takes
categories,searchQueriesandurls;maxPerSource(up to 1,000) applies to each. Filters:country,city,minTrustScore("0", "3", "4", "4.5"),onlyClaimed,minReviewCount,sort. - For TrustMRR and Skool,
maxResults: 0means every match. Skool via the API reads public communities only.
Response
{ "list": { "id": "460b081d-cd98-4ec8-bacc-c50d5e003c71", "status": "running", "result_count": 0 }, "credits": 1450 }Credits for the most the search could cost are reserved when it starts; what it doesn't use comes back when it finishes.