{"name":"RecipeBee","version":"v1","description":"Public REST API for reading RecipeBee recipes, categories, tags, cookbooks, and blog posts, plus NLWeb list-mode search at /ask. The OpenAPI document also describes authenticated image-generation batch routes.","documentation":"https://recipebee.app/developers","llms_txt":"https://recipebee.app/llms.txt","api_llms_txt":"https://recipebee.app/api/llms.txt","pricing":"https://recipebee.app/pricing","versioning":{"current":"v1","style":"url","deprecation_policy":"Deprecated versions are announced with HTTP Deprecation and Sunset headers. RecipeBee keeps a deprecated version available for at least 12 months.","policy_url":"https://recipebee.app/developers#versioning"},"pagination":{"preferred":"cursor","cursor":{"request":["cursor","per_page"],"response":["data.meta.next_cursor","data.links.next"]},"page":{"request":["page","per_page"],"response":["data.meta.current_page","data.links.next"]}},"rate_limit":{"headers":["RateLimit","RateLimit-Limit","RateLimit-Remaining","RateLimit-Reset","Retry-After"],"legacy_headers":["X-RateLimit-Limit","X-RateLimit-Remaining","X-RateLimit-Reset"]},"openapi":{"json":"https://recipebee.app/openapi.json","yaml":"https://recipebee.app/api/openapi.yaml"},"mcp":{"url":"https://recipebee.app/mcp","transport":"streamable-http","server_card":"https://recipebee.app/.well-known/mcp/server-card.json"},"endpoints":[{"method":"GET","path":"/ask","description":"Search public recipes with NLWeb v0.55 list mode"},{"method":"POST","path":"/ask","description":"Search public recipes with NLWeb v0.55 list mode and optional SSE streaming"},{"method":"GET","path":"/api/v1/public/recipes","description":"List and search public recipes"},{"method":"GET","path":"/api/v1/public/recipes/{slug}","description":"Get a public recipe by slug"},{"method":"GET","path":"/api/v1/categories","description":"List recipe categories"},{"method":"GET","path":"/api/v1/categories/{category}","description":"Get an active category by slug"},{"method":"GET","path":"/api/v1/tags","description":"List recipe tags"},{"method":"GET","path":"/api/v1/tags/{slug}","description":"Get an active tag and its public recipes by slug"},{"method":"GET","path":"/api/v1/public/cookbooks/{slug}","description":"Get a public shared cookbook"},{"method":"GET","path":"/api/v1/blog-posts","description":"List public blog posts"},{"method":"GET","path":"/api/v1/blog-posts/{slug}","description":"Get a published blog post by slug"},{"method":"GET","path":"/api/v1/health","description":"API health check"},{"method":"POST","path":"/api/v1/image-generation-batches","description":"Create an authenticated, zero-cost image batch for review"},{"method":"GET","path":"/api/v1/image-generation-batches/{batch}","description":"Read image batch status and progress for the authenticated user"},{"method":"POST","path":"/api/v1/image-generation-batches/{batch}/start","description":"Queue selected images after explicit confirmation; may reserve credits"},{"method":"POST","path":"/api/v1/image-generation-batches/{batch}/retry","description":"Return failed image items to review; confirmation is required before retrying generation"},{"method":"POST","path":"/api/v1/image-generation-batches/{batch}/cancel","description":"Cancel queued image generation for the authenticated user"}]}