farmersfridge.com APIfarmersfridge.com ↗
Retrieve Farmer's Fridge menu items, nutrition facts, allergens, kiosk locations, and real-time stock counts at specific fridges via a structured API.
curl -X GET 'https://api.parse.bot/scraper/1590ed90-b186-4e77-8722-43910d0b41eb/get_menu?category=Salads' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all products on the general menu, optionally filtered by category. Products include basic info like name, SKU, calories, and image URL.
| Param | Type | Description |
|---|---|---|
| category | string | Filter by category name. Accepted values: Bowls, Breakfast, Featured, High Protein, Salads, Sandwiches & Wraps, Sides & Snacks. |
{
"type": "object",
"fields": {
"products": "array of product objects with id, sku, name, category, calories, slug, image_url"
},
"sample": {
"data": {
"products": [
{
"id": "f0949eaf-f26b-597d-b495-f7e974025322",
"sku": "STEAKHOUSE_CHOPPED_SALAD",
"name": "Steakhouse Chopped Salad",
"slug": "steakhouse-chopped-salad",
"calories": [
"Salad: 340 Cal",
"Dressing: 250 Cal"
],
"category": "Salads",
"image_url": "https://res.cloudinary.com/farmers-fridge/image/upload/v1752013690/Products/Steakhouse_Chopped_Salad/BlockOut/Image.png"
}
]
},
"status": "success"
}
}About the farmersfridge.com API
The Farmer's Fridge API covers 7 endpoints that expose the full menu catalog, per-product nutrition and allergen data, kiosk location listings, and live inventory counts at individual fridges. Use get_location_menu to pull real-time prices and stock counts for every item stocked at a specific fridge, or use get_product_details to retrieve the complete ingredient breakdown, allergen list, and nutrition facts for any menu item by its slug.
Menu and Product Data
The get_menu endpoint returns an array of product objects — each including id, sku, name, category, calories, slug, and image_url — and accepts an optional category filter. Valid category values are Bowls, Breakfast, Featured, High Protein, Salads, and Sandwiches & Wraps. Use get_menu_categories to retrieve the current category list programmatically. For full per-product detail, pass any product slug from get_menu to get_product_details, which returns components (an array of ingredient groups), a comma-separated allergens string, nutrition_facts text, and both jar and plate images.
Kiosk Locations
get_locations returns location objects containing id, fridgeId, name, slug, address, access, vertical, coordinates, and hours. Two optional filters are available: access_type (Public or Private) and location_type (Airport, B&I, Big Box, Education, Healthcare, Office, and others). Call get_location_types to retrieve the exact accepted string values before filtering. The fridgeId field from any location record is the key input for all inventory-related endpoints.
Real-Time Inventory
get_location_menu accepts a fridge_id and returns the live menu for that fridge, including each item's price (in cents), count, status, and foodInfo fields covering allergens, calorie string, and ingredients. To check a single product's availability at one fridge, get_product_at_location takes both a slug and a fridge_id and returns price (in dollars), status, and stock_count. If the product is not stocked at that location, the endpoint returns a stale_input indicator rather than an error.
- Display live menu and stock counts for a specific fridge in a workplace or airport wayfinding app
- Build a nutrition tracker that pulls calorie counts and allergen data from
get_product_details - Map Farmer's Fridge kiosk locations filtered by
HealthcareorAirportvertical for a venue guide - Alert users when a specific salad or bowl is back in stock at their nearest fridge
- Aggregate price data across multiple fridge locations using
get_location_menuresponses - Filter menu items by category (e.g. High Protein or Breakfast) to build a diet-specific browsing interface
- Cross-reference
componentsandallergensfields to flag products safe for specific dietary restrictions
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Farmer's Fridge have an official developer API?+
What does `get_product_at_location` return when a product isn't available at a fridge?+
stale_input indicator rather than throwing an error. This lets you distinguish between a product that exists on the general menu but is simply not stocked at that specific fridge, without breaking your request flow.Does the API cover historical inventory or stock trends over time?+
get_location_menu and get_product_at_location — return current stock counts and status only. There are no historical or time-series inventory fields in the response. You can fork this API on Parse and revise it to log and persist inventory snapshots over time to build your own trend data.Can I search for locations near a specific address or coordinate?+
get_locations endpoint returns coordinates for each kiosk and supports filtering by access_type and location_type, but there is no built-in radius or proximity search parameter. You can fork this API on Parse and revise it to add a geo-distance filtering layer on top of the coordinates returned.How are prices represented across the inventory endpoints?+
get_location_menu returns item prices in cents as an integer, while get_product_at_location returns price in dollars as a number. Make sure to account for this unit difference when combining data from both endpoints.