{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Maps Reviews Scraper: Ratings, Replies, Dates",
    "description": "Export public Google Maps reviews: stars, full text, exact date, reviewer, photos and owner replies, plus each place's star breakdown. Paste share links, place IDs or searches, and keep only recent reviews such as the last 30 days. Translated reviews come with the original.",
    "version": "0.1",
    "x-build-id": "n1vtTv3LZQJcfXrax"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automatic~google-maps-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automatic-google-maps-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/automatic~google-maps-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-automatic-google-maps-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/automatic~google-maps-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-automatic-google-maps-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "placeUrls": {
            "title": "Google Maps place links",
            "maxItems": 100,
            "type": "array",
            "description": "Links to Google Maps places: share links (https://maps.app.goo.gl/...), full place links copied from the address bar, or links with query_place_id. Google Maps search links are searched too. Leave every source empty for a ten-review sample.",
            "items": {
              "type": "string"
            }
          },
          "placeIds": {
            "title": "Google place IDs",
            "maxItems": 100,
            "type": "array",
            "description": "Google place IDs, for example ChIJG-gJw2vKRIYROWi2uwOp8QE. Standard IDs that start with ChIJ are supported; for other formats paste the place link instead.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Find places by search",
            "maxItems": 100,
            "type": "array",
            "description": "Business names or categories to search on Google Maps, one per line, for example dentist or Joe's Pizza. Add a location below, or include the area in each term. Reviews are collected from the top places of every search.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Search location",
            "maxLength": 300,
            "type": "string",
            "description": "City or area added to every search, for example Austin, TX or Berlin, Germany. Optional when the search terms already name the area."
          },
          "maxPlaces": {
            "title": "Places per search",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many top places to take from each search, for example 3. Places given by link or ID are always included.",
            "default": 5
          },
          "maxReviewsPerPlace": {
            "title": "Maximum reviews inspected per place",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum distinct reviews to inspect per place, including reviews excluded by date or already seen. Example: 200. Limits work on scheduled runs too.",
            "default": 100
          },
          "maxItems": {
            "title": "Maximum output reviews",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum review rows saved across all places, for example 200. Set 1 for one review.",
            "default": 200
          },
          "sort": {
            "title": "Review order",
            "enum": [
              "newest",
              "mostRelevant",
              "highest",
              "lowest"
            ],
            "type": "string",
            "description": "Order to request from Google Maps, for example newest for scheduled monitoring.",
            "default": "newest"
          },
          "reviewsStartDate": {
            "title": "Only reviews newer than",
            "maxLength": 40,
            "type": "string",
            "description": "A date (2026-11-01), a UTC timestamp (2026-11-01T12:00:00Z) or a period such as 30 days, 2 weeks, 6 months or 1 year. Leave empty for every date. With Newest order the run stops reading a place once it reaches older reviews."
          },
          "language": {
            "title": "Review language",
            "maxLength": 8,
            "type": "string",
            "description": "Language for review text, for example en, de or pt-BR. Reviews written in another language are translated by Google; the original text is kept in originalLanguageText.",
            "default": "en"
          },
          "onlyNewSinceLastRun": {
            "title": "Only reviews not saved before",
            "type": "boolean",
            "description": "Save only review IDs absent from the named ledger. Use the same ledgerName on repeat runs; example true. The first enabled run establishes its baseline by saving reviews.",
            "default": false
          },
          "ledgerName": {
            "title": "Saved-review ledger name",
            "maxLength": 63,
            "type": "string",
            "description": "Saved-review history name, for example agency-client-a-reviews. Separate names are independent; a second run with the same name succeeds with zero reviews while the first is using it.",
            "default": "google-maps-reviews-ledger"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}