google-maps-leads

🧭 Google Maps Leads – Local Business Search by Keyword & Location

The Google Maps Leads Actor searches Google Maps for local businesses based on a keyword and map location, then returns clean JSON leads that you can export to CSV/Excel or send to other systems.

Typical use cases include local lead generation, sales prospecting, agency reporting, and market research. For each place, the Actor calls a backend API (via bigyellow.sbs) and normalizes the response into an easy‑to‑use dataset.

📥 Input Parameters

All parameters are provided as a JSON object in the Input tab.

1. keywords (string, required)

• Description: Search query you would normally type into Google Maps.
• Examples:
  • "Hotels in San Francisco, USA"
  • "Dentists near New York"
  • "Coffee shop Shanghai"

If this field is empty or missing, the run fails with a validation error.

2. lat (string, optional)

• Description: Latitude of the map center, in decimal degrees.
• Example: "37.7749"
• Notes:
  • If provided together with lon, the search is centered around this coordinate.
  • If omitted, the backend may rely more on the textual keywords for location context.

3. lon (string, optional)

• Description: Longitude of the map center, in decimal degrees.
• Example: "-122.4194"
• Notes:
  • Should be used together with lat.
  • If omitted, behavior is the same as above.

4. zoom (integer, optional, default 14)

• Description: Map zoom level roughly controlling how wide the search area is.
• Typical range: 10–18
  • Lower value → larger area, more dispersed results.
  • Higher value → smaller area, more focused around the center.

5. lang (string, optional, default "en")

• Description: Language code for place details (where supported by Google).
• Examples: "en", "zh-CN", "es", "fr".

Example Input

{
  "keywords": "Hotels in San Francisco, USA",
  "lat": "37.7749",
  "lon": "-122.4194",
  "zoom": 14,
  "lang": "en"
}