Google Maps Top List & Ranked Places Extractor

{
  "properties": {
    "countryCodes": {
      "default": [],
      "description": "Keep places in these two-letter countries, e.g. FR, US, JP. Empty means all countries.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Country codes",
      "type": "array"
    },
    "enrichDetails": {
      "default": true,
      "description": "Adds Plus Code, rating histogram, photos, amenities, price range, booking links, closure state and hotel details. Turn it off for the fastest, smallest runs using list-feed data only.",
      "prefill": false,
      "title": "Fetch full place details",
      "type": "boolean"
    },
    "excludeCategories": {
      "default": [],
      "description": "Drop places whose primary or secondary category contains any of these words.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Exclude categories",
      "type": "array"
    },
    "hasPhone": {
      "default": false,
      "description": "Keep only places with a published phone number.",
      "prefill": false,
      "title": "Must have a phone number",
      "type": "boolean"
    },
    "hasWebsite": {
      "default": false,
      "description": "Keep only places with a published website.",
      "prefill": false,
      "title": "Must have a website",
      "type": "boolean"
    },
    "includeCategories": {
      "default": [],
      "description": "Keep places whose primary or secondary category contains any of these words.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [],
      "title": "Include categories",
      "type": "array"
    },
    "includeClosed": {
      "default": true,
      "description": "When disabled, permanently closed places are dropped. This needs full place details.",
      "prefill": true,
      "title": "Include permanently closed places",
      "type": "boolean"
    },
    "language": {
      "default": "en",
      "description": "Google Maps interface language. Names, categories, addresses and hours are localized.",
      "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"
      ],
      "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",
        "Ελληνικά",
        "български",
        "кыргызча",
        "қазақ тілі",
        "македонски",
        "монгол",
        "Русский",
        "српски",
        "Українська",
        "ქართული",
        "հայերեն",
        "עברית",
        "اردو",
        "العربية",
        "فارسی",
        "አማርኛ",
        "नेपाली",
        "हिन्दी",
        "मराठी",
        "বাংলা",
        "ਪੰਜਾਬੀ",
        "ગુજરાતી",
        "தமிழ்",
        "తెలుగు",
        "ಕನ್ನಡ",
        "മലയാളം",
        "සිංහල",
        "ไทย",
        "ລາວ",
        "ဗမာ",
        "ខ្មែរ",
        "한국어",
        "日本語",
        "简体中文",
        "繁體中文"
      ],
      "prefill": "en",
      "title": "Language",
      "type": "string"
    },
    "listUrls": {
      "description": "Public Google Maps shared-list links (google.com/maps/placelists/list/...) or Maps search URLs. Short maps.app.goo.gl links are resolved automatically.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Shared list or Maps URLs",
      "type": "array"
    },
    "location": {
      "default": "",
      "description": "Optional city, neighborhood or region appended to every query when it is not already mentioned.",
      "editor": "textfield",
      "prefill": "",
      "title": "Location",
      "type": "string"
    },
    "maxRating": {
      "default": 5,
      "description": "Drop places with a higher rating.",
      "maximum": 5,
      "minimum": 0,
      "prefill": 5,
      "title": "Maximum rating",
      "type": "number"
    },
    "maxResults": {
      "default": 30,
      "description": "Maximum places to return per query or list. The public feed may expose fewer; lists are returned up to the source window.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max results",
      "type": "integer"
    },
    "maxReviews": {
      "default": 0,
      "description": "Drop places with more reviews.",
      "minimum": 0,
      "prefill": 0,
      "title": "Maximum review count",
      "type": "integer"
    },
    "minRating": {
      "default": 0,
      "description": "Drop places with a lower rating or no published rating.",
      "maximum": 5,
      "minimum": 0,
      "prefill": 0,
      "title": "Minimum rating",
      "type": "number"
    },
    "minReviews": {
      "default": 0,
      "description": "Drop places with fewer reviews or no published review count.",
      "minimum": 0,
      "prefill": 0,
      "title": "Minimum review count",
      "type": "integer"
    },
    "mode": {
      "default": "topList",
      "description": "Use 'topList' for ranked queries like 'Top hotels in Paris'. Use 'listUrl' for a shared Google Maps list link or a Maps search URL.",
      "editor": "select",
      "enum": [
        "topList",
        "listUrl"
      ],
      "enumTitles": [
        "Top list query",
        "Shared list or Maps URL"
      ],
      "title": "Mode",
      "type": "string"
    },
    "nameFilter": {
      "default": "",
      "description": "Keep only places whose name contains this text (case-insensitive).",
      "editor": "textfield",
      "prefill": "",
      "title": "Name contains",
      "type": "string"
    },
    "openNow": {
      "default": false,
      "description": "Keep only places Google currently marks as open.",
      "prefill": false,
      "title": "Open now",
      "type": "boolean"
    },
    "queries": {
      "description": "Ranked list queries. For example: 'Top hotels in Paris', 'Best coffee in Brooklyn', 'Things to do in Tokyo'. Each query is scraped separately.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "Top hotels in Paris"
      ],
      "title": "Queries",
      "type": "array"
    }
  },
  "schemaVersion": 1,
  "title": "Google Maps Top List & Ranked Places Extractor",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Ranked places from a Google Maps Top list or list/search URL, with rank, rating and optional full place details.",
  "properties": {
    "places": {
      "description": "Each item contains only fields observed on the public list or place page.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Places",
      "type": "string"
    }
  },
  "title": "Google Maps Top List & Ranked Places Extractor Output"
}

{
  "actorSpecification": 1,
  "views": {
    "detailed": {
      "display": {
        "component": "table"
      },
      "title": "Detailed Place Data",
      "transformation": {
        "fields": [
          "recordType",
          "rank",
          "listSource",
          "listId",
          "listTitle",
          "listUrl",
          "listDescription",
          "listOwner",
          "note",
          "savedAt",
          "name",
          "categoryName",
          "categories",
          "description",
          "totalScore",
          "reviewsCount",
          "ratingHistogram",
          "address",
          "plusCode",
          "location",
          "latitude",
          "longitude",
          "timezone",
          "countryCode",
          "phone",
          "website",
          "menuLink",
          "bookingLinks",
          "hours",
          "hoursStatus",
          "isOpenNow",
          "price",
          "priceRange",
          "priceLevel",
          "priceOfferAmount",
          "priceOfferCurrency",
          "priceOfferDateRange",
          "serviceOptions",
          "amenities",
          "placeAttributes",
          "attributes",
          "highlights",
          "hotelStars",
          "hotelStarRating",
          "hotelAmenities",
          "fuelPrices",
          "photosSample",
          "photoCount",
          "hasStreetView",
          "streetViewCount",
          "claimed",
          "temporarilyClosed",
          "permanentlyClosed",
          "placeId",
          "featureId",
          "kgmid",
          "cid",
          "googleMapsUrl",
          "sourceUrl",
          "scrapedAt"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "address": {
            "label": "Address"
          },
          "categoryName": {
            "label": "Category"
          },
          "googleMapsUrl": {
            "label": "Maps URL"
          },
          "highlights": {
            "label": "Highlights"
          },
          "name": {
            "label": "Name"
          },
          "price": {
            "label": "Price (as shown)"
          },
          "priceLevel": {
            "label": "Price Level"
          },
          "rank": {
            "label": "Rank"
          },
          "reviewsCount": {
            "label": "Reviews"
          },
          "totalScore": {
            "label": "Rating"
          }
        }
      },
      "title": "Ranked Places",
      "transformation": {
        "fields": [
          "recordType",
          "rank",
          "listSource",
          "name",
          "categoryName",
          "totalScore",
          "reviewsCount",
          "address",
          "priceLevel",
          "price",
          "highlights",
          "googleMapsUrl",
          "scrapedAt"
        ]
      }
    }
  }
}