eFarmz APIefarmz.be ↗
Access eFarmz.be weekly meal boxes, product search, fruits & vegetables listings, and full product details via a structured JSON API.
What is the eFarmz API?
The eFarmz.be API exposes 4 endpoints covering Belgium's organic meal box service: retrieve weekly cooking boxes by ISO week number via get_weekly_mealboxes, search the product catalog by keyword, fetch detailed product records including allergens and brand data, and list every item in the fruits and vegetables category across all sub-categories. Responses include fields like primary_tag, price, origin, brand, and category hierarchy.
curl -X GET 'https://api.parse.bot/scraper/915f9bce-6e61-4654-9f7f-7e32bc0e82a9/get_weekly_mealboxes?week=38&year=2026&language=fr' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the first 18 cooking meal box names and their tags available for a given week. Each meal box has one or more tags from: Classique, Famille, Express, Healthy, Veggie. A primary_tag is determined by priority order (Healthy > Express > Veggie > Famille > Classique). Returns cooking boxes only (excludes reheat boxes), in the chosen language (French or Dutch).
| Param | Type | Description |
|---|---|---|
| weekrequired | string | ISO week number (1-53). For example: '23' corresponds to 01/06-07/06 in 2026, '24' to 08/06-14/06, etc. |
| year | string | 4-digit year for the period lookup. |
| language | string | Language for meal box names. |
{
"type": "object",
"fields": {
"week": "integer - ISO week number",
"year": "integer - year",
"total": "integer - number of meal boxes returned (max 18)",
"period": "string - the YYYYWW period code sent to the site",
"language": "string - language code used ('fr' or 'nl')",
"mealboxes": "array of meal box objects, each containing position (integer, 1-based order on the website), name (string), primary_tag (string, highest priority tag), and tags (array of strings, all applicable tags sorted by priority)"
},
"sample": {
"data": {
"week": 24,
"year": 2026,
"total": 18,
"period": "202624",
"language": "fr",
"mealboxes": [
{
"name": "Tagliata de boeuf, sauce au persil et aubergines grillées au citron",
"tags": [
"Classique"
],
"position": 1,
"primary_tag": "Classique"
},
{
"name": "Riz au chorizo et poivrons",
"tags": [
"Express"
],
"position": 2,
"primary_tag": "Express"
}
]
},
"status": "success"
}
}About the eFarmz API
Weekly Meal Boxes
The get_weekly_mealboxes endpoint takes an ISO week number (1–53) and an optional year to return up to 18 cooking box options available that week on eFarmz.be. Each meal box object includes its position on the site, name, and a primary_tag derived from a fixed priority order: Healthy > Express > Veggie > Famille > Classique. A period field returns the YYYYWW code used for the lookup, and the language parameter switches names between French (fr) and Dutch (nl).
Product Search and Detail
search_products accepts a query string (e.g. 'tomate', 'fromage') and returns up to 10 matching products. Each result includes id, name, slug, price in EUR, brand, origin (country code), conditioning, tags, categories, and is_available status. The product_id values from search results feed directly into get_product_detail, which returns extended data: full description, ingredients, allergen information, a brand object with name, description and image, deposit amount, and the full category hierarchy.
Fruits and Vegetables Listing
list_fruits_and_vegetables walks the entire eFarmz fruits and vegetables shop category — covering vegetables, fruits, organic baskets, and herbs — and returns every product found. The response includes total, total_pages, and pages_fetched so you can verify complete traversal. Each product entry carries an id, name, slug, url in the requested language, and summary pricing and category fields consistent with the search endpoint.
The eFarmz API is a managed, monitored endpoint for efarmz.be — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when efarmz.be changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official efarmz.be API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a weekly meal plan tracker that pulls current box options and filters by primary_tag (e.g. only Veggie or Healthy boxes).
- Aggregate eFarmz product prices for organic produce price monitoring across Belgian e-commerce.
- Generate a structured catalog of all eFarmz fruits and vegetables using list_fruits_and_vegetables for a comparison shopping tool.
- Look up allergen and ingredient details for specific products via get_product_detail to support dietary filtering applications.
- Map product origin country codes from search_products results to visualise sourcing geography for organic goods.
- Feed meal box names and tags into a recommendation engine that matches boxes to user dietary preferences.
- Track week-over-week changes in meal box availability by polling get_weekly_mealboxes across consecutive ISO week numbers.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.