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 ```json { "keywords": "Hotels in San Francisco, USA", "lat": "37.7749", "lon": "-122.4194", "zoom": 14, "lang": "en" }