Launch extractions from your scripts, feed your CRM automatically, or let an AI assistant query your prospect database directly.
Every request requires an API key, generated from your workspace.
Authorization: Bearer msk_live_YOUR_KEYAPI access is included from the Pro plan. Rate limits are 120 requests/minute on Pro and 600 requests/minute on Scale. Every response carries the X-RateLimit-*headers.
/api/v1/searchLaunches a search. With `wait: true`, returns the results directly.
/api/v1/searchLists the organisation's searches.
/api/v1/search/{id}Status, progress and statistics for one search.
/api/v1/search/{id}/resultsPaginated results, with filters as URL parameters.
/api/v1/search/{id}Deletes a search and its results.
/api/v1/categoriesTaxonomy of 370 categories and the geographic reference data.
/api/v1/meOrganisation, plan, remaining quota and rate limits.
Find every plumber in Lyon with no website but whose email we have.
curl -X POST https://mysearch.gg/api/v1/search \
-H "Authorization: Bearer msk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"category": "plumber",
"location": "Chicago, United States",
"filters": { "website": "no", "email": "yes" },
"limit": 500,
"wait": true
}'{
"search_id": "8f3c…",
"status": "completed",
"location": "Chicago",
"stats": {
"total": 412,
"with_email": 251,
"without_website": 198,
"average_score": 71
},
"places": [
{
"place_id": "ChIJ…",
"name": "Miller & Sons Plumbing",
"address": { "city": "Chicago", "postal_code": "60614" },
"phone": "+13125550142",
"emails": [
{ "email": "contact@…", "source": "website_mailto", "confidence": 92 }
],
"website": null,
"rating": 4.8,
"review_count": 127,
"score": {
"value": 92,
"grade": "A",
"signals": [
{ "key": "no_website", "kind": "opportunity", "label": "No website" }
]
}
}
]
}In the request body for POST /search, as URL parameters for GET /results.
websiteyes / noHas a website, or notemailyes / noAn email was foundphoneyes / noA phone number is presentmobileyes / noThe number is a mobileclaimedyes / noThe Google listing is claimedfacebook / instagram / linkedinyes / noPresent on that networkrating_min / rating_max0 – 5Rating boundsreviews_min / reviews_maxintegerReview-count boundsscore_min0 – 100Minimum lead scoremissing_api_key / invalid_api_keyKey missing, invalid or revokedquota_exceededLead quota exhausted for the cycleplan_requiredFeature not included in the plannot_foundResource not foundinvalid_requestMissing or invalid parametersrate_limit_exceeded / too_many_jobsToo many requests or concurrent searchesengine_unavailableExtraction engine temporarily unavailablePlug Claude, ChatGPT or Gemini straight into mySearch. The assistant launches searches and reasons over the results without going through an export.
search_places— launches a search and returns the enriched resultsget_results— walks through a search's results with filterslist_searches— lists searches and their statusmarket_stats— aggregated read on a market: digital maturity, lead qualitylist_categories— explores the category taxonomyExample question for a connected assistant: “How many restaurants in Bordeaux have no website? Give me the twenty with the most reviews.”
{
"mcpServers": {
"mysearch": {
"type": "http",
"url": "https://mysearch.gg/api/mcp",
"headers": { "Authorization": "Bearer msk_live_YOUR_KEY" }
}
}
}