#Documentation This is the documentation for the partner endpoint of the BigOven Recipe and Grocery List API. The update brings with it Swagger-based documentation. [Swagger](http://swagger.io)
Full LLM thinking from the 4-phase benchmark pipeline.
{
"service_type": "api",
"base_url": "https://api.bigoven.com",
"auth_method": "api_key",
"auth_config": {
"api_key_in": "header",
"api_key_name": "X-BigOven-Api-Key",
"header": "X-BigOven-Api-Key: YOUR_API_KEY",
"docs": "https://api2.bigoven.com/"
},
"endpoints": [
"GET /recipe/{id}",
"GET /recipe/{id}/images",
"GET /recipe/instructions/{id}",
"GET /recipe/ingredient/{ingredient}",
"GET /recipe/search",
"GET /recipe/search/simple",
"GET /recipe/search/advanced",
"GET /recipe/featured",
"GET /recipe/popular",
"GET /category",
"GET /cuisine",
"GET /event",
"GET /food/{id}",
"GET /food/search",
"GET /grocerylist",
"POST /grocerylist/items",
"PUT /grocerylist/items/{id}",
"DELETE /grocerylist/items/{id}",
"GET /user",
"GET /user/recipe",
"POST /recipe",
"PUT /recipe/{id}",
"DELETE /recipe/{id}",
"POST /recipe/{id}/image",
"POST /recipe/{id}/category",
"GET /recipe/{id}/similar",
"GET /savedrecipe",
"POST /savedrecipe",
"DELETE /savedrecipe/{id}"
],
"pricing_model": {
"type": "subscription",
"details": {
"partner_api_key_required": true,
"requires_partner_account_approval": true,
"usage_based_tiers_exist": true,
"free_tier_available": false,
"pricing_info_url": "https://bigoven.com/partner/partnerapi"
}
},
"rate_limits": {
"general": "Not documented; likely part of partner agreement"
},
"capabilities": [
"Search recipes by name, ingredient, cuisine, category, course, and other criteria",
"Retrieve detailed recipe information including ingredients, instructions, nutrition, and metadata",
"Access recipe images and video",
"Manage user recipe collections (add, retrieve, delete saved recipes)",
"Create, edit, delete recipes in the BigOven database",
"Manage grocery lists (GET, add, update, remove grocery list items)",
"Retrieve user profile information",
"Access categories, cuisines, and food ingredient data",
"Get featured and popular recipes",
"Full CRUD for recipe, grocery list, and saved recipes",
"Partner API documentation with Swagger/OpenAPI 2.0 spec"
],
"raw_analysis": "BigOven provides a comprehensive recipe and grocery list API aimed at partners and developers who want to integrate a large recipe database (over 1,000,000 recipes) and grocery list management into their applications. The API requires an API key and partner account approval, indicating a professional business model rather than a fully open public API. It offers extensive recipe search and retrieval, as well as CRUD operations for recipes, grocery lists, and saved recipes. The API is documented via Swagger/OpenAPI and appears well-structured for integration. However, rate limits and pricing details are not publicly disclosed; they are likely negotiated per agreement. The API is primarily suited for culinary apps, nutrition trackers, meal planning tools, and e-commerce integrations. The platform demonstrates a mature ecosystem with well-defined endpoints and features. Potential challenges include the requirement for a partner account and possible usage costs, which may limit access for hobby developers."
}1/3 tests passed
| Test | Endpoint | Status | Latency |
|---|---|---|---|
| website_uptime | GET / | 200 | 284ms |
| robots_txt | GET /robots.txt | 404 | 65ms |
| llms_txt | GET /llms.txt | 404 | 62ms |
{
"overall": 32,
"dimensions": {
"token_efficiency": 6.0,
"first_try_success": 3.0,
"response_parseability": 7.0,
"error_clarity": 4.0,
"doc_quality": 5.0,
"auth_simplicity": 2.0,
"latency": 7.0,
"consistency": 3.0
},
"pricing_normalized": {
"free_tier": false,
"requires_approval": true,
"pricing_visibility": "partial"
},
"issues": [
"Requires partner account approval - no instant signup",
"No free tier available - subscription required with approval",
"robots.txt returns 404 (should exist)",
"llms.txt not available (agent discoverability low)",
"Website lacks security headers",
"Robots.txt 404 suggests poor bot/agent accessibility maintenance"
],
"recommendations": [
"Provide an instant-access free tier or sandbox for evaluation",
"Publish llms.txt to help AI agents understand capabilities directly",
"Fix robots.txt to allow proper crawling and provide clear site structure",
"Add clear API documentation with examples and error codes",
"Consider offering an API key without manual approval for low-risk usage",
"Publish a public status page to increase reliability transparency"
]
}Show your live agent-readiness score on your own site. Free, no auth — it updates as your score changes.
<a href="https://prowl.world/service/1000000-recipe-and-grocery-list-api-v2">
<img src="https://prowl.world/badge/1000000-recipe-and-grocery-list-api-v2.svg" height="56" alt="Agent-readiness on Prowl">
</a>
See operational metrics, LLM evaluations, agent readiness, and more.
Open in Dashboard