# Google Maps Menu Scraper — Place to Structured Menu API (`nomad-agent/google-maps-menu-scraper`) Actor
Turn any Google Maps place into a structured menu: scrapes the place's Menu photos and AI-parses every dish — translated name, price, atomic ingredients, EU-14 allergens with confidence, dietary type (vegan/vegetarian/pescetarian), nutrition estimates and origin story. Bring your own Gemini key.
- **URL**: https://apify.com/nomad-agent/google-maps-menu-scraper.md
- **Developed by:** [Nomad.Dev](https://apify.com/nomad-agent) (community)
- **Categories:** AI, Travel
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $4.00 / 1,000 dish extracteds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Google Maps Menu Scraper — Place → Structured Menu API
Give it a Google Maps place URL (or place ID) and get back the restaurant's
**menu as structured data** — no website scraping, no PDF parsing. The actor
opens the place's photo gallery, collects the **Menu** photos that guests and
owners uploaded, and AI-parses them into one record per dish:
- `name` (translated to your language) + `originalName` (as printed)
- `category`, `price` (with currency, as shown)
- `ingredients` — atomic base ingredients, each with an English database
name, translated display name, and **EU-14 allergens with confidence**
(gluten, crustaceans, eggs, fish, peanuts, soy, milk, nuts, celery,
mustard, sesame, sulfites, lupin, molluscs)
- `dietaryType` — Vegan / Vegetarian / Pescetarian / Other, with explanation
- `nutritionInfo` — estimated serving size, calories, protein, fat, carbs
- `story` — origin story / cultural significance
- `isAlcoholic` for beverages
### Why this actor
Generic Google Maps scrapers give you reviews and opening hours. This one
answers the question they can't: **what can I actually eat there?** Built
from the production pipeline of a dietary-restrictions travel app, so the
allergen and dietary classification prompts are battle-tested on real menus
in 15 languages.
### Bring your own Gemini key
Menu parsing runs on **your** Google AI Studio key
([get one free](https://aistudio.google.com/apikey)) — you control the AI
cost and quota. A typical menu runs a few cents on Gemini 3.5 Flash, or a
fraction of that on Flash-Lite.
### Input example
```json
{
"placeUrls": ["https://www.google.com/maps/place/Katz's+Delicatessen,+205+E+Houston+St,+New+York"],
"geminiApiKey": "AIza…",
"language": "en",
"maxMenuPhotos": 8
}
````
### Photo source: add an Outscraper key (recommended)
Since 2026 Google's signed-out "limited view" hides the Maps photo gallery
from automated browsers, so set the `outscraperApiKey` input
([free tier available](https://app.outscraper.com/profile)) — the actor then
fetches the place's full tagged photo set (including the Menu photos) via
Outscraper's API, no browser or proxy involved. Without it, the actor falls
back to browser scraping, which currently reaches only the cover photo.
### Notes
- In browser-fallback mode, use the **Apify residential proxy** (default) —
Google rate-limits datacenter IPs.
- Places with no menu photos on Google Maps yield a non-billed
diagnostic row explaining why.
- Already have menu photo URLs? Use the companion **AI Restaurant Menu
Parser** actor and skip the browser. Want the place's food photos matched
to these dishes? Chain the **Restaurant Dish Photo Matcher** actor.
# Actor input Schema
## `placeUrls` (type: `array`):
Google Maps place URLs, bare place IDs (ChIJ…), or plain place names (e.g. Katz's Delicatessen New York — resolved via Maps search). One structured menu is extracted per place.
## `geminiApiKey` (type: `string`):
Your Google AI Studio API key — get a free one at aistudio.google.com/apikey. Menu parsing runs on YOUR key, so you control the AI cost (a menu typically costs well under $0.01 on Gemini Flash).
## `outscraperApiKey` (type: `string`):
API key from app.outscraper.com (free tier available). Google's signed-out "limited view" hides the Maps photo gallery from browsers, so this is the reliable way to fetch a place's tagged photos. Without it, the actor falls back to browser scraping, which currently reaches only the cover photo.
## `geminiModel` (type: `string`):
Model used to read the menu photos.
## `language` (type: `string`):
Language for dish names, descriptions, stories and allergen summaries (ingredient database names stay English).
## `maxMenuPhotos` (type: `integer`):
How many of the place's menu photos are sent to the AI. 8 covers most menus; raise it for very long menus.
## `proxyConfiguration` (type: `object`):
Proxy used to open Google Maps. Google rate-limits datacenter IPs, so the Apify residential proxy is recommended.
## Actor input object example
```json
{
"placeUrls": [
"Katz's Delicatessen New York"
],
"geminiModel": "gemini-3.5-flash",
"language": "en",
"maxMenuPhotos": 8,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"placeUrls": [
"Katz's Delicatessen New York"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("nomad-agent/google-maps-menu-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"placeUrls": ["Katz's Delicatessen New York"],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("nomad-agent/google-maps-menu-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"placeUrls": [
"Katz'\''s Delicatessen New York"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call nomad-agent/google-maps-menu-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=nomad-agent/google-maps-menu-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Menu Scraper — Place to Structured Menu API",
"description": "Turn any Google Maps place into a structured menu: scrapes the place's Menu photos and AI-parses every dish — translated name, price, atomic ingredients, EU-14 allergens with confidence, dietary type (vegan/vegetarian/pescetarian), nutrition estimates and origin story. Bring your own Gemini key.",
"version": "0.1",
"x-build-id": "heQrr2A3vdvxtD2Y7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nomad-agent~google-maps-menu-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nomad-agent-google-maps-menu-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/nomad-agent~google-maps-menu-scraper/runs": {
"post": {
"operationId": "runs-sync-nomad-agent-google-maps-menu-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/nomad-agent~google-maps-menu-scraper/run-sync": {
"post": {
"operationId": "run-sync-nomad-agent-google-maps-menu-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",
"required": [
"placeUrls",
"geminiApiKey"
],
"properties": {
"placeUrls": {
"title": "Google Maps places",
"type": "array",
"description": "Google Maps place URLs, bare place IDs (ChIJ…), or plain place names (e.g. Katz's Delicatessen New York — resolved via Maps search). One structured menu is extracted per place.",
"items": {
"type": "string"
}
},
"geminiApiKey": {
"title": "Gemini API key (bring your own)",
"type": "string",
"description": "Your Google AI Studio API key — get a free one at aistudio.google.com/apikey. Menu parsing runs on YOUR key, so you control the AI cost (a menu typically costs well under $0.01 on Gemini Flash)."
},
"outscraperApiKey": {
"title": "Outscraper API key (recommended)",
"type": "string",
"description": "API key from app.outscraper.com (free tier available). Google's signed-out \"limited view\" hides the Maps photo gallery from browsers, so this is the reliable way to fetch a place's tagged photos. Without it, the actor falls back to browser scraping, which currently reaches only the cover photo."
},
"geminiModel": {
"title": "Gemini model",
"enum": [
"gemini-3.5-flash",
"gemini-3.1-flash-lite",
"gemini-3.1-pro-preview"
],
"type": "string",
"description": "Model used to read the menu photos.",
"default": "gemini-3.5-flash"
},
"language": {
"title": "Output language",
"enum": [
"en",
"es",
"fr",
"de",
"it",
"pt",
"ru",
"zh",
"ja",
"ko",
"ar",
"hi",
"uk",
"ka",
"eu"
],
"type": "string",
"description": "Language for dish names, descriptions, stories and allergen summaries (ingredient database names stay English).",
"default": "en"
},
"maxMenuPhotos": {
"title": "Max menu photos per place",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many of the place's menu photos are sent to the AI. 8 covers most menus; raise it for very long menus.",
"default": 8
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy used to open Google Maps. Google rate-limits datacenter IPs, so the Apify residential proxy is recommended."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```