Pricing

from $20.00 / 1,000 contributor analyzeds

Google Maps Reviewer Geo Profile API

Infer a Google Maps reviewer's home region from their review history. Clusters review coordinates into a standardized home-region guess (city/state/country + ISO codes), a confidence score, and a local-vs-travel footprint. One row per reviewer, for reviewer vetting and fraud research. MCP-ready.

Pricing

from $20.00 / 1,000 contributor analyzeds

Rating

0.0

(0)

Developer

John

Actor stats

Bookmarked

Total users

Monthly active users

2 days ago

Last modified

Categories

Lead generation

Developer tools

MCP servers

You can access the Google Maps Reviewer Geo Profile API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "G5HRwn371TgWx20y9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/johnvc~google-maps-reviewer-geo-profile-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-johnvc-google-maps-reviewer-geo-profile-api",
        "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/johnvc~google-maps-reviewer-geo-profile-api/runs": {
      "post": {
        "operationId": "runs-sync-johnvc-google-maps-reviewer-geo-profile-api",
        "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/johnvc~google-maps-reviewer-geo-profile-api/run-sync": {
      "post": {
        "operationId": "run-sync-johnvc-google-maps-reviewer-geo-profile-api",
        "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": {
          "contributorId": {
            "title": "Contributor ID",
            "type": "string",
            "description": "Enter a single Google Maps contributor ID (the long numeric ID from a reviewer's profile, e.g. '107022004965696773221'). Provide this, `contributorIds`, or both. You can read a contributor ID from any place review's reviewer."
          },
          "contributorIds": {
            "title": "Contributor IDs",
            "type": "array",
            "description": "Provide a list of Google Maps contributor IDs to profile in one run. Merged with `contributorId` and de-duplicated. One derived row is returned per reviewer.",
            "items": {
              "type": "string"
            }
          },
          "regionGranularity": {
            "title": "Region Granularity",
            "enum": [
              "city",
              "admin1",
              "country"
            ],
            "type": "string",
            "description": "Level the home-region guess and confidence are computed at: 'city' (e.g. Chicago, IL), 'admin1' (state or province), or 'country'. The row always includes the full standardized breakdown (city, admin, country, ISO codes) regardless. Default 'city'.",
            "default": "city"
          },
          "minCityPopulation": {
            "title": "Minimum City Population",
            "minimum": 0,
            "type": "integer",
            "description": "Snap each review to the nearest city with at least this population, so big-metro neighborhoods (e.g. 'Chicago Loop') group under the principal city ('Chicago'). Default 100000. Lower it (e.g. 1000) to keep smaller towns distinct, at the cost of large metros fragmenting across neighborhoods.",
            "default": 100000
          },
          "hl": {
            "title": "Language Code",
            "type": "string",
            "description": "Set the two-letter interface language code (e.g. 'en', 'es', 'de'). Affects the source review text; the region output is standardized independently of this. Defaults to 'en'.",
            "default": "en"
          },
          "maxResultsPerContributor": {
            "title": "Maximum Reviews Per Contributor",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "How many reviews to analyze per contributor, most recent first. Default 100, maximum 200. Deeper history sharpens the home-region signal by diluting a travel-heavy recent window; the analysis cost is the same at any depth. The endpoint returns fewer if the contributor has fewer.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Google Maps Reviewer Geo Profile API OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Google Maps Reviewer Geo Profile API from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Google Maps Reviewer Geo Profile API API in Python

Google Maps Reviewer Geo Profile API API in JavaScript

Google Maps Reviewer Geo Profile API API through CLI

Google Maps Reviewer Geo Profile API API

Google Maps Contributor Reviews | Reviewer History API

johnvc/google-maps-contributor-reviews-api

--> Pull a Google Maps contributor's review history as structured JSON: every review with rating, text, date, photos, and the place reviewed, plus the reviewer's level, points, and local-guide status. For reputation research, reviewer vetting, and review-fraud detection. Pay per review, MCP-ready.

John

5.0

Google Maps Reviews Scraper — Local Review Monitoring API

nexgendata/google-maps-reviews

Extract every Google Maps review for any place — reviewer, star rating, text, date, owner replies, likes. No Google API key. Paste a place URL, business name or search query. For reputation monitoring, review analysis and local SEO.

NexGenData

Google Maps Reviews Scraper

thodor/google-maps-reviews-scraper

Extract every Google Maps review from any place URL. Get full text, star ratings, detailed sub-ratings, reviewer profiles, owner responses, images, and ISO dates.

Thodor

Google Maps Reviews Scraper

webscrapewizard/google-maps-reviews-scraper

Extract all reviews of Google Maps places using place URLs or Review urls. Get review text, published date, response from owner, review URL, and reviewer's details.

WebScraperWizard

453

3.6

Google Maps REVIEWS Scraper

dtrungtin/google-maps-reviews-scraper

Extract reviews from any **[Google Maps](https://www.google.com/maps)** place at scale. The scraper collects review text, ratings, reviewer profiles, photos, and timestamps

Tin

Google Maps Review Scraper

scrapesmith/Google-Maps-Reviews-Scraper

Extract all reviews from Google Maps place URLs, including review text, date, rating, reviewer name and profile link, owner responses, and review URLs — with full API support, scheduling, monitoring, and data download capabilities.

Scrape Smith

316

5.0

Google Maps Review Scraper

moving_beacon-owner1/my-actor-35

A powerful scraping actor that gathers structured reviews from **Google Maps listings. Capture reviewer information, star ratings, review content, images, and timestamps with automated scrolling and sorting options. Perfect for competitive analysis and sentiment research.

Jamshaid Arif

Ultimate Google Maps Reviews Scraper | Apify Actor

yasir-on-apify/ultimate-google-maps-reviews-scraper-apify-actor

Only $0.0025/review. Scrape Google Maps reviews with this Apify actor. Extract Google Maps business reviews using business URL including reviewer name, rating, text, photos, timestamps, and profile links. Perfect for lead generation, local SEO, review aggregation, and Google Maps data extraction.

Yasir

Advanced Google Maps Reviews Scraper

slash-scrape/advanced-google-maps-reviews-scraper

This Google Maps Reviews scraper lets you collect reviews for places from public Google Maps pages. You can get the star rating, review text, photos and images, response from the place, and (optionally) some details about the reviewer like their name and a link to their profile.

slash scrape

492

3.0

Google Maps Reviews Scraper

crawlerbros/google-maps-reviews-scraper

Extract detailed reviews from any Google Maps business page. This scraper retrieves reviewer information, ratings, review text, dates, likes, and owner responses.