# Picnic Scraper — Grocery Delivery Products & Prices (`studio-amba/picnic-scraper`) Actor Scrape product data from Picnic, the popular online grocery delivery service in the Netherlands and Germany. Extract product names, prices, categories, and availability. No login or cookies required. - **URL**: https://apify.com/studio-amba/picnic-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Picnic Scraper Scrape grocery product data from Picnic, the popular online-only supermarket in the Netherlands and Germany. Extract product names, prices, categories, unit pricing, and availability. ### Why use this actor? Track grocery prices, monitor product availability, or build price comparison tools for Picnic's online delivery service. Perfect for market researchers, price comparison platforms, and anyone monitoring the Dutch and German online grocery market. No login or cookies required. ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQuery` | String | No | Search for products by name or keyword (e.g. "melk", "kaas", "Milch") | | `country` | String | No | Country store to scrape: `NL` (Netherlands, default) or `DE` (Germany) | | `categoryUrl` | String | No | Specific category URL or path to scrape (e.g. "zuivel-eieren") | | `maxResults` | Integer | No | Maximum results to return (default: 100) | | `proxyConfiguration` | Object | No | Proxy settings for large-scale scraping | ### Output Each result contains: | Field | Type | Example | |-------|------|---------| | `name` | String | `"Halfvolle melk"` | | `brand` | String | `"Campina"` | | `price` | Number | `1.29` | | `currency` | String | `"EUR"` | | `pricePerUnit` | String | `"€1.29/L"` | | `category` | String | `"Zuivel & Eieren"` | | `imageUrl` | String | Product image URL | | `description` | String | `"1L pak"` | | `inStock` | Boolean | `true` | | `quantity` | String | `"1L"` | | `unit` | String | `"L"` | | `url` | String | Full product URL on Picnic | | `scrapedAt` | String | ISO 8601 timestamp | ### Example output ```json { "name": "Halfvolle melk", "brand": "Campina", "price": 1.29, "currency": "EUR", "pricePerUnit": "€1.29/L", "category": "Zuivel & Eieren", "imageUrl": "https://storefront.getpicnic.com/static/images/abc123/medium.png", "description": "Verse halfvolle melk, 1 liter pak", "inStock": true, "quantity": "1L", "unit": "L", "url": "https://picnic.app/nl/product/halfvolle-melk", "scrapedAt": "2026-04-07T10:30:00.000Z" } ```` ### How it works The scraper uses a multi-strategy approach to extract product data from Picnic: 1. **API search** — Attempts Picnic's storefront API endpoints for fast, structured product data 2. **Web scraping** — Falls back to scraping picnic.app HTML pages, including embedded JSON data (Next.js/Nuxt hydration data) and structured data (JSON-LD) 3. **Category browsing** — Follows category links to discover more products ### Supported countries - **Netherlands (NL)** — picnic.app/nl - **Germany (DE)** — picnic.app/de ### Cost estimate This actor uses approximately **0.5 compute units per 1,000 results**. At standard Apify pricing, that's roughly **$0.25 per 1,000 products**. ### Use cases - **Price monitoring** — Track grocery prices over time across Picnic's catalog - **Price comparison** — Compare Picnic prices with other online supermarkets (Albert Heijn, Jumbo, REWE) - **Market research** — Analyze product assortment, pricing strategies, and availability patterns - **Competitor intelligence** — Monitor new product launches and promotional pricing - **Data analysis** — Build datasets for grocery market analysis in NL and DE ### Limitations - Picnic is primarily an app-based service; some product data may require authentication - Product availability varies by delivery area - The scraper attempts multiple strategies (API + web scraping) to maximize data extraction - Data is scraped from public-facing pages and may change without notice - Respect the website's terms of service and use responsibly # Actor input Schema ## `searchQuery` (type: `string`): Search for products by name or keyword (e.g. 'melk', 'kaas', 'Milch'). Leave empty to browse categories. ## `country` (type: `string`): Which Picnic country store to scrape. ## `categoryUrl` (type: `string`): Optional: a specific Picnic category URL or path to scrape (e.g. 'zuivel-eieren'). Overrides search query if provided. ## `maxResults` (type: `integer`): Maximum number of products to scrape. ## `proxyConfiguration` (type: `object`): Proxy settings. Datacenter proxies usually work fine for Picnic. ## Actor input object example ```json { "searchQuery": "melk", "country": "NL", "maxResults": 100 } ``` # 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 = { "searchQuery": "melk" }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/picnic-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 = { "searchQuery": "melk" } # Run the Actor and wait for it to finish run = client.actor("studio-amba/picnic-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 '{ "searchQuery": "melk" }' | apify call studio-amba/picnic-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/picnic-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Picnic Scraper — Grocery Delivery Products & Prices", "description": "Scrape product data from Picnic, the popular online grocery delivery service in the Netherlands and Germany. Extract product names, prices, categories, and availability. No login or cookies required.", "version": "0.1", "x-build-id": "BxlKAOx1Q7Sw8MFCn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~picnic-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-picnic-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/studio-amba~picnic-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-picnic-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/studio-amba~picnic-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-picnic-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search for products by name or keyword (e.g. 'melk', 'kaas', 'Milch'). Leave empty to browse categories." }, "country": { "title": "Country", "enum": [ "NL", "DE" ], "type": "string", "description": "Which Picnic country store to scrape.", "default": "NL" }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "Optional: a specific Picnic category URL or path to scrape (e.g. 'zuivel-eieren'). Overrides search query if provided." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to scrape.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Datacenter proxies usually work fine for Picnic." } } }, "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 } } } } } } } } } } ```