# Crisp Scraper - Dutch Online Grocery & Food Delivery (`studio-amba/crisp-scraper`) Actor

Scrape products, prices, and recipes from Crisp.nl and Crisp.app. Dutch and Belgian online grocery delivery with fresh, local, and sustainable food. Extract featured products, weekly recipes, and ingredient data.

- **URL**: https://apify.com/studio-amba/crisp-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

## Crisp Scraper

Scrape products, prices, and recipe ingredients from Crisp.nl and Crisp.app. Crisp is a Dutch and Belgian online grocery delivery service that focuses on fresh, local, and sustainable food sourced directly from farmers, bakers, and artisans.

### How it works

Crisp is an app-first grocery platform. Their website embeds product data as `window.ssrData` JSON in the server-rendered HTML. The scraper parses this embedded data to extract:

- **Featured products** from the homepage (with prices and images)
- **Weekly recipe ingredients** from the Weekbox page (with quantities)
- Data from both the **Dutch** (crisp.nl) and **Belgian** (crisp.app) markets

No login or cookies required. The scraper reads publicly available data from the website.

### Input

| Field | Type | Description |
|-------|------|-------------|
| `searchQuery` | string | Filter products by keyword (e.g., `"kaas"`, `"vis"`, `"groenten"`) |
| `categoryUrl` | string | Specific Crisp page URL to scrape |
| `maxResults` | integer | Limit (default: 100) |
| `proxyConfiguration` | object | Proxy settings |

When no `searchQuery` or `categoryUrl` is provided, the scraper defaults to searching for `"kaas"` across all pages.

### Output

| Field | Type | Example |
|-------|------|---------|
| `name` | string | `"Cherry trostomaten"` |
| `brand` | string | `"Crisp"` |
| `price` | number | `3.29` |
| `currency` | string | `"EUR"` |
| `pricePerUnit` | string | Per unit price if available |
| `originalPrice` | number | Price before discount |
| `inStock` | boolean | `true` |
| `url` | string | Source page URL |
| `imageUrl` | string | Product image |
| `description` | string | `"Veel verser dan elders"` |
| `category` | string | `"featured"` or `"weekbox-ingredient"` |
| `weight` | string | `"500 g"` |
| `origin` | string | Producer or farm info |
| `organic` | boolean | Organic certification status |
| `allergens` | string | Allergen info |
| `nutritionInfo` | string | Nutritional details |
| `market` | string | `"nl"` or `"be"` |

### Markets

| Market | Domain | Country |
|--------|--------|---------|
| nl | crisp.nl | Netherlands |
| be | crisp.app | Belgium |

Both markets are scraped by default. The Belgian market may have slightly different prices and product names (e.g., "plattekaas" instead of "kwark").

### Data sources

The scraper extracts data from two main sections of the Crisp website:

1. **Homepage featured products** -- curated selection with name, price, subtitle, and image
2. **Weekbox recipes** -- weekly meal kit ingredients with product names and quantities

Note: Crisp's full product catalog is only accessible through their mobile app. The website provides a curated subset of their assortment.

### Cost

Very efficient. The scraper makes only 4 HTTP requests (homepage + weekbox for each market). Typical cost is under $0.01 per run.

### Why use Crisp Scraper

- **Market research** -- Monitor Crisp's product assortment and pricing trends
- **Competitive intelligence** -- Compare Crisp prices against other Dutch grocery services
- **Recipe analysis** -- Track which ingredients appear in weekly meal kits
- **Food trends** -- Analyze seasonal product rotation and featured items
- **Price comparison** -- Compare NL vs BE pricing for the same products
- **No login or cookies required** -- Works out of the box with publicly available data

### How to use Crisp Scraper

1. Open the **Input** tab and optionally provide a search query to filter products
2. Adjust optional settings like `maxResults` or proxy configuration
3. Click **Start** and wait for the run to complete
4. Download results from the **Output** tab in JSON, CSV, Excel, XML, or HTML
5. Schedule recurring runs from the **Schedule** tab if you need ongoing data

### How to scrape Crisp data

This Actor automates the process of extracting structured product data from Crisp.
You can run it directly from the Apify console, the Apify API, or any of the
official SDKs (JavaScript, Python). The scraper handles retries and proxy
rotation so you can focus on the data, not the plumbing.

Typical workflows:

- **One-off export**: set a search query or leave empty for all available products, run once
- **Scheduled monitoring**: set a daily cron in the Schedule tab to track prices over time
- **Programmatic integration**: trigger runs from your backend via the Apify API and
  pull the dataset when finished
- **Webhook automation**: receive a callback the moment a run completes and pipe
  the results into Zapier, Make, n8n, BigQuery, or Google Sheets
- **NL vs BE comparison**: the scraper covers both markets, making cross-border
  price analysis straightforward

### Tips for best results

- **Start small** -- run with `maxResults: 10` before launching large jobs
- **Use proxies** -- residential proxies with NL country code reduce blocking risk
- **Empty search** -- leave `searchQuery` empty to get all available products
- **Keyword filter** -- use Dutch keywords like `"groenten"`, `"fruit"`, `"vlees"`, `"zuivel"`
- **Schedule runs** -- daily or weekly runs capture Crisp's rotating assortment

### FAQ and support

**Is it legal to scrape Crisp?** This Actor extracts publicly available data from
the Crisp website. Always review the website's Terms of Service before scraping at
scale, and respect rate limits.

**Why are there fewer products than expected?** Crisp is an app-first platform. Their
website only showcases a curated selection of products. The full catalog (1000+ items)
is only available through the Crisp mobile app.

**Can I get the full Crisp catalog?** The website provides featured products and weekly
recipe ingredients. For the full catalog, the Crisp mobile app would need to be used.

**What is the Weekbox?** Crisp's Weekbox is a weekly meal kit with pre-selected recipes
and ingredients. The scraper extracts all ingredients from the current week's recipes.

**Why do some products have price 0?** Weekbox recipe ingredients are listed by name
and quantity but don't have individual prices on the website. Only the featured
homepage products have prices.

For issues, feature requests, or bug reports, open a ticket in the Issues tab on
the Actor page or contact support@apify.com. We monitor every actor and ship
fixes quickly when sites change.

# Actor input Schema

## `searchQuery` (type: `string`):

Filter products by keyword (e.g., 'kaas', 'groenten', 'vis'). Matches against product names in the scraped data.
## `categoryUrl` (type: `string`):

A Crisp page URL to scrape (e.g., https://crisp.nl/weekbox). If empty, scrapes the homepage and weekbox pages.
## `maxResults` (type: `integer`):

Maximum number of products to return.
## `proxyConfiguration` (type: `object`):

Proxy settings for better reliability.

## Actor input object example

```json
{
  "searchQuery": "kaas",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}
````

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "kaas",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "NL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/crisp-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "kaas",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "NL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/crisp-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": "kaas",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}' |
apify call studio-amba/crisp-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=studio-amba/crisp-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Crisp Scraper - Dutch Online Grocery & Food Delivery",
        "description": "Scrape products, prices, and recipes from Crisp.nl and Crisp.app. Dutch and Belgian online grocery delivery with fresh, local, and sustainable food. Extract featured products, weekly recipes, and ingredient data.",
        "version": "0.1",
        "x-build-id": "z6Jw1GrJ3s7OLKDIC"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/studio-amba~crisp-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-studio-amba-crisp-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~crisp-scraper/runs": {
            "post": {
                "operationId": "runs-sync-studio-amba-crisp-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~crisp-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-studio-amba-crisp-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": "Filter products by keyword (e.g., 'kaas', 'groenten', 'vis'). Matches against product names in the scraped data."
                    },
                    "categoryUrl": {
                        "title": "Category URL",
                        "type": "string",
                        "description": "A Crisp page URL to scrape (e.g., https://crisp.nl/weekbox). If empty, scrapes the homepage and weekbox pages."
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Maximum number of products to return.",
                        "default": 100
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings for better reliability."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
