Google Maps Top List & Ranked Places Extractor: MCP config, n8n workflow and API

{
  "queries": [
    "Top hotels in Paris"
  ],
  "maxResults": 3,
  "enrichDetails": false,
  "language": "en",
  "minRating": 0,
  "maxRating": 5,
  "minReviews": 0,
  "maxReviews": 0,
  "openNow": false,
  "hasWebsite": false,
  "hasPhone": false,
  "includeClosed": true
}

---
name: google-maps-top-list-and-ranked-places-extractor
description: "Ranked places from a Google Maps Top list or list/search URL, with rank, rating and optional full place details. Runs the Apify Actor dataspryva/google-maps-top-list-and-ranked-places-extractor. Use when the user needs Google Maps data with fields such as recordType, rank, listSource, name, categoryName, totalScore and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/google-maps-top-list-and-ranked-places-extractor"
  store-url: "https://apify.com/dataspryva/google-maps-top-list-and-ranked-places-extractor"
---

# Google Maps Top List & Ranked Places Extractor

Use this skill to fetch Google Maps data with the Apify Actor `dataspryva/google-maps-top-list-and-ranked-places-extractor` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `queries` | array | Ranked list queries. For example: 'Top hotels in Paris', 'Best coffee in Brooklyn', 'Things to do in Tokyo'. Each query is scraped separately. |
| `location` | string | Optional city, neighborhood or region appended to every query when it is not already mentioned. |
| `maxResults` | integer | Maximum places to return per query or list. The public feed may expose fewer; lists are returned up to the source window. |
| `enrichDetails` | boolean | 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. |
| `language` | string | Google Maps interface language. Names, categories, addresses and hours are localized. |
| `minRating` | number | Drop places with a lower rating or no published rating. |
| `maxRating` | number | Drop places with a higher rating. |
| `minReviews` | integer | Drop places with fewer reviews or no published review count. |
| `maxReviews` | integer | Drop places with more reviews. |
| `openNow` | boolean | Keep only places Google currently marks as open. |
| `hasWebsite` | boolean | Keep only places with a published website. |
| `hasPhone` | boolean | Keep only places with a published phone number. |
| `includeClosed` | boolean | When disabled, permanently closed places are dropped. This needs full place details. |
| `nameFilter` | string | Keep only places whose name contains this text (case-insensitive). |

Example `input.json` (the Actor's published prefill):

```json
{
  "queries": [
    "Top hotels in Paris"
  ],
  "maxResults": 3,
  "enrichDetails": false,
  "language": "en",
  "minRating": 0,
  "maxRating": 5,
  "minReviews": 0,
  "maxReviews": 0,
  "openNow": false,
  "hasWebsite": false,
  "hasPhone": false,
  "includeClosed": true
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~google-maps-top-list-and-ranked-places-extractor/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~google-maps-top-list-and-ranked-places-extractor/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `recordType`, `rank`, `listSource`, `name`, `categoryName`, `totalScore`, `reviewsCount`, `address`, `priceLevel`, `price`, `highlights`, `googleMapsUrl`, `scrapedAt`, `listId`, `listTitle`, `listUrl`, `listDescription`, `listOwner`, `note`, `savedAt`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.