Google Maps Business Lead & Email Finder

{
  "description": "Find local businesses on Google Maps and read their own websites for emails, phone numbers and social profiles.",
  "properties": {
    "category": {
      "default": "bakery",
      "description": "Business category such as bakery, dentist or plumber. Used when keyword and search phrases are empty.",
      "editor": "textfield",
      "prefill": "bakery",
      "title": "Category",
      "type": "string"
    },
    "categoryFilter": {
      "description": "Keep places whose Google Maps category contains all words of at least one entry. Leave empty for no category filter.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Category filter words",
      "type": "array"
    },
    "country": {
      "default": "US",
      "description": "Country for the search. Other countries can be named directly in a search phrase.",
      "editor": "select",
      "enum": [
        "US",
        "GB",
        "CA",
        "AU",
        "DE",
        "FR",
        "IN",
        "BR",
        "MX",
        "JP",
        "KR",
        "CN",
        "AE",
        "SG"
      ],
      "enumTitles": [
        "United States",
        "United Kingdom",
        "Canada",
        "Australia",
        "Germany",
        "France",
        "India",
        "Brazil",
        "Mexico",
        "Japan",
        "South Korea",
        "China",
        "United Arab Emirates",
        "Singapore"
      ],
      "prefill": "US",
      "title": "Country",
      "type": "string"
    },
    "extractEmails": {
      "default": true,
      "description": "Visit each business website for public emails, phone numbers and social profiles. Turn off for a faster Maps-only run.",
      "prefill": true,
      "sectionCaption": "Contact extraction",
      "title": "Find emails and social profiles",
      "type": "boolean"
    },
    "keyword": {
      "description": "Custom search term such as 'boutique coffee' or 'pet grooming'. Takes priority over category.",
      "editor": "textfield",
      "title": "Keyword (overrides category)",
      "type": "string"
    },
    "language": {
      "default": "en",
      "description": "Language of the Google Maps interface and listing text.",
      "editor": "select",
      "enum": [
        "en",
        "af",
        "az",
        "id",
        "ms",
        "bs",
        "ca",
        "cs",
        "da",
        "de",
        "et",
        "es",
        "es-419",
        "eu",
        "fil",
        "fr",
        "gl",
        "hr",
        "zu",
        "is",
        "it",
        "sw",
        "lv",
        "lt",
        "hu",
        "nl",
        "no",
        "uz",
        "pl",
        "pt-BR",
        "pt-PT",
        "ro",
        "sq",
        "sk",
        "sl",
        "fi",
        "sv",
        "vi",
        "tr",
        "el",
        "bg",
        "ky",
        "kk",
        "mk",
        "mn",
        "ru",
        "sr",
        "uk",
        "ka",
        "hy",
        "iw",
        "ur",
        "ar",
        "fa",
        "am",
        "ne",
        "hi",
        "mr",
        "bn",
        "pa",
        "gu",
        "ta",
        "te",
        "kn",
        "ml",
        "si",
        "th",
        "lo",
        "my",
        "km",
        "ko",
        "ja",
        "zh-CN",
        "zh-TW",
        "zh",
        "pt"
      ],
      "enumTitles": [
        "English",
        "Afrikaans",
        "azərbaycan",
        "Bahasa Indonesia",
        "Bahasa Melayu",
        "bosanski",
        "català",
        "Čeština",
        "Dansk",
        "Deutsch",
        "eesti",
        "Español",
        "Español (Latinoamérica)",
        "euskara",
        "Filipino",
        "Français",
        "galego",
        "Hrvatski",
        "isiZulu",
        "íslenska",
        "Italiano",
        "Kiswahili",
        "latviešu",
        "lietuvių",
        "magyar",
        "Nederlands",
        "norsk",
        "oʻzbekcha",
        "polski",
        "Português (Brasil)",
        "Português (Portugal)",
        "română",
        "shqip",
        "Slovenčina",
        "slovenščina",
        "Suomi",
        "Svenska",
        "Tiếng Việt",
        "Türkçe",
        "Ελληνικά",
        "български",
        "кыргызча",
        "қазақ тілі",
        "македонски",
        "монгол",
        "Русский",
        "српски",
        "Українська",
        "ქართული",
        "հայերեն",
        "עברית",
        "اردو",
        "العربية",
        "فارسی",
        "አማርኛ",
        "नेपाली",
        "हिन्दी",
        "मराठी",
        "বাংলা",
        "ਪੰਜਾਬੀ",
        "ગુજરાતી",
        "தமிழ்",
        "తెలుగు",
        "ಕನ್ನಡ",
        "മലയാളം",
        "සිංහල",
        "ไทย",
        "ລາວ",
        "ဗမာ",
        "ខ្មែរ",
        "한국어",
        "日本語",
        "简体中文",
        "繁體中文",
        "中文 (Chinese)",
        "Português"
      ],
      "prefill": "en",
      "title": "Language",
      "type": "string"
    },
    "locationQuery": {
      "description": "Adds a shared location to every search phrase, for example 'Austin, TX, USA'. Leave empty when your phrases already name the place.",
      "editor": "textfield",
      "prefill": "",
      "title": "Location (optional)",
      "type": "string"
    },
    "maxContactPagesPerWebsite": {
      "default": 3,
      "description": "Homepage plus contact, about, legal, privacy or careers pages to read. More pages find more contacts but take longer.",
      "maximum": 10,
      "minimum": 1,
      "prefill": 2,
      "sectionCaption": "Filters and results",
      "title": "Pages checked per website",
      "type": "integer"
    },
    "maxEmailsPerWebsite": {
      "default": 5,
      "description": "Maximum email addresses to keep for one business website.",
      "maximum": 20,
      "minimum": 1,
      "prefill": 3,
      "title": "Emails per website",
      "type": "integer"
    },
    "max_results": {
      "default": 100,
      "description": "Maximum number of leads to save. Google returns a ranked window of roughly 150-220 businesses per search phrase, so a larger request may end when that window ends.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 3,
      "sectionCaption": "Limits and language",
      "title": "Maximum leads",
      "type": "integer"
    },
    "minRating": {
      "description": "Keep only businesses rated at least this value (1.0-5.0). Leave empty for any rating.",
      "maximum": 5,
      "minimum": 1,
      "title": "Minimum rating",
      "type": "number"
    },
    "mode": {
      "default": "searchPlaces",
      "description": "Search Google Maps, look up specific places, or enrich a list of websites you already have.",
      "editor": "select",
      "enum": [
        "searchPlaces",
        "specificPlaces",
        "enrichWebsites"
      ],
      "enumTitles": [
        "Search Google Maps for businesses",
        "Look up specific Google Maps places",
        "Get contacts from a list of websites"
      ],
      "prefill": "searchPlaces",
      "sectionCaption": "How to find businesses",
      "title": "What do you want to do?",
      "type": "string"
    },
    "onlySaveResults": {
      "default": "allPlaces",
      "description": "Save every business, only businesses with an email, or only businesses with any contact detail.",
      "editor": "select",
      "enum": [
        "allPlaces",
        "onlyWithEmails",
        "onlyWithContacts"
      ],
      "enumTitles": [
        "All matching businesses",
        "Only businesses with an email",
        "Only businesses with any contact detail"
      ],
      "prefill": "allPlaces",
      "title": "Which places to save",
      "type": "string"
    },
    "placeIds": {
      "description": "Canonical Google Place IDs starting with 'ChIJ'.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Google Place IDs",
      "type": "array"
    },
    "placeUrls": {
      "description": "Google Maps place links copied from the address bar or a previous export.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "sectionCaption": "Look up specific places",
      "sectionDescription": "Used when the selected mode is 'Look up specific Google Maps places'. Provide links, Place IDs, or both.",
      "title": "Google Maps place URLs",
      "type": "array"
    },
    "searchQueries": {
      "description": "Natural-language searches such as 'coffee shops in Austin TX'. Include the place in each phrase, or use the location field below.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "sectionCaption": "Search Google Maps",
      "sectionDescription": "Used when the selected mode is 'Search Google Maps for businesses'.",
      "title": "Search phrases",
      "type": "array"
    },
    "skipClosedPlaces": {
      "default": false,
      "description": "Check Google's public status and leave out permanently or temporarily closed places.",
      "prefill": false,
      "title": "Skip closed places",
      "type": "boolean"
    },
    "state": {
      "default": "All",
      "description": "US state for the search. Choose 'All' for nationwide. Ignored for non-US countries.",
      "editor": "select",
      "enum": [
        "All",
        "AL",
        "AK",
        "AZ",
        "AR",
        "CA",
        "CO",
        "CT",
        "DE",
        "FL",
        "GA",
        "HI",
        "ID",
        "IL",
        "IN",
        "IA",
        "KS",
        "KY",
        "LA",
        "ME",
        "MD",
        "MA",
        "MI",
        "MN",
        "MS",
        "MO",
        "MT",
        "NE",
        "NV",
        "NH",
        "NJ",
        "NM",
        "NY",
        "NC",
        "ND",
        "OH",
        "OK",
        "OR",
        "PA",
        "RI",
        "SC",
        "SD",
        "TN",
        "TX",
        "UT",
        "VT",
        "VA",
        "WA",
        "WV",
        "WI",
        "WY"
      ],
      "enumTitles": [
        "All (nationwide)",
        "Alabama",
        "Alaska",
        "Arizona",
        "Arkansas",
        "California",
        "Colorado",
        "Connecticut",
        "Delaware",
        "Florida",
        "Georgia",
        "Hawaii",
        "Idaho",
        "Illinois",
        "Indiana",
        "Iowa",
        "Kansas",
        "Kentucky",
        "Louisiana",
        "Maine",
        "Maryland",
        "Massachusetts",
        "Michigan",
        "Minnesota",
        "Mississippi",
        "Missouri",
        "Montana",
        "Nebraska",
        "Nevada",
        "New Hampshire",
        "New Jersey",
        "New Mexico",
        "New York",
        "North Carolina",
        "North Dakota",
        "Ohio",
        "Oklahoma",
        "Oregon",
        "Pennsylvania",
        "Rhode Island",
        "South Carolina",
        "South Dakota",
        "Tennessee",
        "Texas",
        "Utah",
        "Vermont",
        "Virginia",
        "Washington",
        "West Virginia",
        "Wisconsin",
        "Wyoming"
      ],
      "prefill": "CA",
      "title": "US state",
      "type": "string"
    },
    "websiteFilter": {
      "default": "allPlaces",
      "description": "Keep all places, only places with a website, or only places without one.",
      "editor": "select",
      "enum": [
        "allPlaces",
        "withWebsite",
        "withoutWebsite"
      ],
      "enumTitles": [
        "All places",
        "Only places with a website",
        "Only places without a website"
      ],
      "prefill": "allPlaces",
      "title": "Website filter",
      "type": "string"
    },
    "websites": {
      "description": "Websites to read for contact details, one per line. Bare domains such as example.com are accepted.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "sectionCaption": "Enrich a list of websites",
      "sectionDescription": "Used when the selected mode is 'Get contacts from a list of websites'.",
      "title": "Business websites",
      "type": "array"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "Google Maps Business Leads Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Dataset of Google Maps business leads with contact details, website emails (source and MX-checked), extra phones, and social profiles.",
  "properties": {
    "results": {
      "description": "One row per business with Maps listing data, website contact details, email provenance and social profiles.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Business Leads",
      "type": "string"
    }
  },
  "title": "Google Maps Business Lead & Email Finder Output"
}

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "city": {
            "format": "text",
            "label": "City"
          },
          "contactPageUrl": {
            "format": "link",
            "label": "Contact page"
          },
          "country": {
            "format": "text",
            "label": "Country"
          },
          "countryCode": {
            "format": "text",
            "label": "Country code"
          },
          "email": {
            "format": "text",
            "label": "Email"
          },
          "emailProvenance": {
            "format": "text",
            "label": "Email sources"
          },
          "emails": {
            "format": "text",
            "label": "Emails"
          },
          "emailsMxValid": {
            "format": "text",
            "label": "MX-valid emails"
          },
          "facebook": {
            "format": "link",
            "label": "Facebook"
          },
          "featureId": {
            "format": "text",
            "label": "Feature ID"
          },
          "googleBusinessCategories": {
            "format": "text",
            "label": "Categories"
          },
          "googleMapsUrl": {
            "format": "link",
            "label": "Google Maps"
          },
          "instagram": {
            "format": "link",
            "label": "Instagram"
          },
          "linkedin": {
            "format": "link",
            "label": "LinkedIn"
          },
          "location": {
            "format": "text",
            "label": "Coordinates"
          },
          "name": {
            "format": "text",
            "label": "Business"
          },
          "phoneNumber": {
            "format": "text",
            "label": "Phone"
          },
          "pinterest": {
            "format": "link",
            "label": "Pinterest"
          },
          "placeId": {
            "format": "text",
            "label": "Place ID"
          },
          "plusCode": {
            "format": "text",
            "label": "Plus Code"
          },
          "priceLevel": {
            "format": "text",
            "label": "Price level"
          },
          "recordType": {
            "format": "text",
            "label": "Record type"
          },
          "reviewScore": {
            "format": "number",
            "label": "Rating"
          },
          "reviewsNumber": {
            "format": "number",
            "label": "Reviews"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped at"
          },
          "sourceUrl": {
            "format": "link",
            "label": "Source URL"
          },
          "state": {
            "format": "text",
            "label": "State / region"
          },
          "street": {
            "format": "text",
            "label": "Street"
          },
          "telegram": {
            "format": "link",
            "label": "Telegram"
          },
          "threads": {
            "format": "link",
            "label": "Threads"
          },
          "tiktok": {
            "format": "link",
            "label": "TikTok"
          },
          "twitter": {
            "format": "link",
            "label": "X / Twitter"
          },
          "url": {
            "format": "link",
            "label": "Website"
          },
          "websitePagesCrawled": {
            "format": "number",
            "label": "Website pages crawled"
          },
          "websitePhones": {
            "format": "text",
            "label": "Website phones"
          },
          "websiteType": {
            "format": "text",
            "label": "Website type"
          },
          "whatsapp": {
            "format": "link",
            "label": "WhatsApp"
          },
          "youtube": {
            "format": "link",
            "label": "YouTube"
          },
          "zip": {
            "format": "text",
            "label": "Postal code"
          }
        }
      },
      "title": "Business Leads",
      "transformation": {
        "fields": [
          "recordType",
          "name",
          "googleBusinessCategories",
          "street",
          "city",
          "state",
          "zip",
          "country",
          "countryCode",
          "phoneNumber",
          "url",
          "email",
          "emails",
          "reviewScore",
          "reviewsNumber",
          "placeId",
          "featureId",
          "googleMapsUrl",
          "priceLevel",
          "plusCode",
          "location",
          "facebook",
          "instagram",
          "linkedin",
          "twitter",
          "youtube",
          "tiktok",
          "websitePhones",
          "contactPageUrl",
          "websitePagesCrawled",
          "scrapedAt",
          "sourceUrl",
          "emailsMxValid",
          "emailProvenance",
          "pinterest",
          "threads",
          "whatsapp",
          "telegram",
          "websiteType"
        ]
      }
    }
  }
}