ConvertFleet

MCP docsTools › Google Maps Search

Google Maps Search

google_maps_search slow · returns a job Local business & map data

Scrape Google Maps business listings (name, address, phone, website, rating, reviews) for a search query and location. Returns B2B leads.

When to use. Building a B2B prospect list of physical/local businesses (name, phone, website, address, rating) for a niche in a city. The default starting point for 'find me leads / businesses / companies in <place>'.
Not for. Finding people or job titles, scraping one known website (use website_email_find), or checking who advertises (use ad_library_lead_finder).

Parameters

NameTypeRequiredDefaultDescription
query string yes What to search for, e.g. 'dentists', 'coffee shops'. Combined with location.
location string no City / area to search in, e.g. 'Miami, FL'.
limit integer no 20 Max number of listings to return (clamped to the account tier ceiling).
language string no Optional 2-letter UI language hint, e.g. 'en'.

Returns

One row per business.

Each row typically carries: store_name category phone whatsapp email website social_media address city province country latitude longitude rating review_count hours_summary permanently_closed maps_url

The response body is { status, count, fields, results }. Runs that exceed the inline wait return { status: "running", job_id, tool_flow } instead — see Jobs & errors.

Call it over MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_maps_search",
    "arguments": {
      "query": "dentists",
      "location": "Miami, FL",
      "limit": 25
    }
  }
}

Call it over the REST API

curl -X POST https://convertfleet.online/api/scrape \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"dentists in Miami, FL","max_results":25}'

Both paths run the same job engine, enforce the same plan limits and count against the same monthly quota. See the REST API page.

Related tools

JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to search for, e.g. 'dentists', 'coffee shops'. Combined with location."
    },
    "location": {
      "type": "string",
      "description": "City / area to search in, e.g. 'Miami, FL'."
    },
    "limit": {
      "type": "integer",
      "description": "Max number of listings to return (clamped to the account tier ceiling).",
      "default": 20
    },
    "language": {
      "type": "string",
      "description": "Optional 2-letter UI language hint, e.g. 'en'."
    }
  },
  "additionalProperties": false,
  "required": [
    "query"
  ]
}