View raw JSON
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"title": "Google Maps Reviews Scraper",
"properties": {
"language": {
"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"
],
"type": "string",
"title": "Language",
"editor": "select",
"default": "en",
"example": "en",
"prefill": "en",
"enumTitles": [
"English",
"Afrikaans",
"azərbaycan",
"BahasaIndonesia",
"BahasaMelayu",
"bosanski",
"català",
"Čeština",
"Dansk",
"Deutsch (Deutschland)",
"eesti",
"Español (España)",
"Español (Latinoamérica)",
"euskara",
"Filipino",
"Français (France)",
"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ếngViệt",
"Türkçe",
"Ελληνικά",
"български",
"кыргызча",
"қазақтілі",
"македонски",
"монгол",
"Русский",
"српски (ћирилица)",
"Українська",
"ქართული",
"հայերեն",
"עברית",
"اردو",
"العربية",
"فارسی",
"አማርኛ",
"नेपाली",
"हिन्दी",
"मराठी",
"বাংলা",
"ਪੰਜਾਬੀ",
"ગુજરાતી",
"தமிழ்",
"తెలుగు",
"ಕನ್ನಡ",
"മലയാളം",
"සිංහල",
"ไทย",
"ລາວ",
"ဗမာ",
"ខ្មែរ",
"한국어",
"日本語",
"简体中文",
"繁體中文"
],
"description": "Optional selection from 74 language codes, with en as the default. Requests localized results and available source translations, not reviews written only in that language or a guaranteed translation of every record."
},
"placeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S+"
},
"title": "🗃 Place IDs",
"editor": "stringList",
"example": [
"ChIJabcdEFGHijklMNOPqrstUVWX"
],
"description": "Optional list of known Google place IDs. The service supports 27-character IDs beginning ChIJ or GhIJ. The example ID illustrates a format rather than a confirmed target."
},
"startUrls": {
"type": "array",
"title": "Google Maps place URLs",
"editor": "requestListSources",
"example": [
{
"url": "https://www.google.com/maps/place/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB"
}
],
"prefill": [
{
"url": "https://www.google.com/maps/place/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB"
}
],
"description": "Optional request-list entries with a url property. Supported targets include Maps search, place and review-detail URLs, plus CID URLs. Supply a supported link rather than a free-text business search; the Yellowstone prefill is an example."
},
"maxReviews": {
"type": "integer",
"unit": "reviews per place",
"title": "Number of reviews",
"default": 10000000,
"example": 100,
"minimum": 1,
"prefill": 100,
"description": "Optional positive integer of at least 1, applied per place. The default is 10,000,000; the prefilled 100 is not the default. Choose an explicit small cap when appropriate. Access and filters may yield fewer reviews, and this does not guarantee complete coverage."
},
"reviewsSort": {
"enum": [
"newest",
"mostRelevant",
"highestRanking",
"lowestRanking"
],
"type": "string",
"title": "Sort reviews by",
"editor": "select",
"default": "newest",
"example": "newest",
"enumTitles": [
"Newest",
"Most relevant",
"Highest ranking",
"Lowest ranking"
],
"description": "Optional newest (default), mostRelevant, highestRanking or lowestRanking. Highest and lowest refer to review ratings, not business search rankings. When using reviewsStartDate, explicitly select newest."
},
"personalData": {
"type": "boolean",
"title": "Personal data",
"default": true,
"example": true,
"description": "Optional, true by default. Controls reviewer ID, name, profile and photo URLs, and the review URL. Switching it off retains the review identifier and does not guarantee fully anonymized text or media."
},
"reviewsOrigin": {
"enum": [
"all",
"google"
],
"type": "string",
"title": "Reviews origin",
"editor": "select",
"default": "all",
"example": "all",
"enumTitles": [
"All reviews",
"Google"
],
"description": "Optional all (default) includes available Google and third-party reviews; google selects Google-native reviews. Sources can use different rating scales. The all option may expose fewer Google reviews, especially for hotels; neither choice guarantees full coverage."
},
"reviewsStartDate": {
"type": "string",
"title": "Only scrape reviews newer than [date]",
"editor": "datepicker",
"example": "2024-01-01",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
"dateType": "absoluteOrRelative",
"description": "Optional publication cutoff using YYYY-MM-DD or ISO date-time in UTC, or a relative period in minutes, hours, days, weeks, months or years. Explicitly choose newest: collection stops at the first older review. The example date is not a default, and the setting does not automatically change sorting."
},
"reviewsFilterString": {
"type": "string",
"title": "Filter reviews by keywords",
"editor": "textarea",
"default": "",
"example": "",
"description": "Optional text requesting reviews containing the given keywords; empty is the default and applies no keyword filter. Google limits the filter to 500 bytes, which may allow fewer non-Latin characters."
}
},
"description": "Optional request object for Maps targets and review settings. To retrieve useful results, supply at least one supported Maps URL or place ID; the input fields themselves are optional.",
"schemaVersion": 1
}
},
"additionalProperties": false
}
