Frequently Asked Questions

Everything you need to know about Recipe API.

Getting Started

What is Recipe API?

Recipe API is a production-ready REST API that provides structured recipe data for developers building food and cooking applications. Each recipe includes detailed ingredients, step-by-step instructions with temperatures and timings, comprehensive nutrition data (32 nutrients per serving), dietary flags, and more.

How do I get an API key?

Getting started is simple:

  1. Visit /signup and enter your email
  2. Check your inbox for a magic link
  3. Click the link to activate your account and receive your API key

No credit card required for the free tier.

What format are responses in?

All API responses are in JSON format. Recipes follow a consistent schema with structured data for ingredients (with quantities, units, and substitutions), instructions (with actions, temperatures, and doneness cues), and nutrition (32 nutrients per serving).

Try it now without signup: curl https://recipe-api.com/api/v1/dinner

Is there a rate limit?

Yes, rate limits depend on your plan:

  • Free: 100 requests/day, 100 unique recipes/mo
  • Hobby ($9/mo): 500 requests/day, 500 unique recipes/mo
  • Starter ($59/mo): 2,000 requests/day, 2,500 unique recipes/mo
  • Pro ($199/mo): 50,000 requests/day, 10,000 unique recipes/mo

See our plan comparison for full details.

What is the unique recipes limit?

The unique recipes limit tracks how many different recipes you access per billing period. Re-requesting the same recipe doesn't count against this limit—only new recipes do.

This encourages caching (which is good for both performance and API efficiency) and ensures fair access to our recipe database across all users.

Can I cache the recipe data?

Yes! Caching rights depend on your plan:

  • Free: No caching (evaluation only)
  • Hobby ($9/mo): 24-hour local caching
  • Starter ($59/mo): Permanent caching—build your own database
  • Pro ($199/mo): Unlimited caching + white-label rights

With Starter and above, you own the data you fetch. Cache it permanently, build your own database, reduce latency, and never worry about API availability for data you've already retrieved.

What does "white-label" mean on the Pro plan?

White-label means you can present the recipe data as your own without any attribution to Recipe API. You can:

  • • Rebrand the data as "[Your Company] Recipes"
  • • Resell as part of your own product
  • • Remove all Recipe API references

This is ideal for agencies, SaaS platforms, and enterprises building recipe features for their clients.

Data & Quality

How accurate is the nutrition data?

Our nutrition data is sourced primarily from USDA FoodData Central and other verified databases. Each recipe includes 32 nutrients per serving:

  • • Calories, protein, carbohydrates, fat (including saturated, trans, mono, poly)
  • • Fiber, sugar, sodium, cholesterol
  • • Vitamins A, C, D, E, K, B6, B12, thiamin, riboflavin, niacin, folate
  • • Minerals: calcium, iron, magnesium, phosphorus, potassium, zinc

Each ingredient shows its nutrition source (e.g., "USDA FoodData Central").

Where does the recipe data come from?

All recipes are professionally developed and curated. Each recipe includes:

  • • Structured ingredients with precise quantities and units
  • • Step-by-step instructions with actions, temperatures, and timings
  • • Troubleshooting tips for common issues
  • • Chef notes with professional techniques
  • • Cultural context where relevant
  • • Storage and reheating instructions
How often is new content added?

We add new recipes regularly. Our database currently includes 25,000+ recipes across multiple cuisines, categories, and dietary preferences. New recipes are added weekly.

Do I need to attribute recipes to Recipe API?

No, attribution is not required. You can use the recipe data freely in your applications under your own brand. This applies to all plans including Free.

Technical

What happens if I exceed my rate limit?

You'll receive a 429 Too Many Requests response with a Retry-After header indicating when you can retry.

Free tier: Wait for the limit to reset (per-minute resets every 60s, daily resets rolling 24h).

Paid tiers: Contact us if you need temporary increases for special circumstances.

Can I cache API responses?

Yes, absolutely. Recipe data is stable and caching is encouraged. You can cache responses for as long as you need to optimize your application's performance and reduce API calls.

Is there an SDK or client library?

Not yet, but the API is straightforward REST/JSON that works with any HTTP client. We provide code examples for JavaScript, Python, and cURL in our documentation.

An OpenAPI spec is available at /openapi.json for generating clients in any language.

What's the typical response time?

API responses are typically under 100ms (p95) globally. Our infrastructure is hosted on Fly.io with edge locations for low latency.

What authentication method do you use?

API requests are authenticated using an API key passed in the X-API-Key header. Keys have the format rapi_...

Your API key is shown once when you activate your account. You can regenerate it anytime from the developer portal.

Can I search or filter by ingredient?

Yes! We provide a dedicated ingredients database with 10,000+ ingredients across 23 categories:

  • /api/v1/ingredients - Browse and search ingredients by name or category
  • /api/v1/ingredient-categories - List all 23 ingredient categories
  • /api/v1/recipes?ingredients=id1,id2 - Find recipes containing specific ingredients

Categories include: Vegetables, Beef, Poultry, Seafood, Dairy & Eggs, Legumes, Grains & Pasta, Fruits, Spices & Herbs, and more.

Billing

How do I upgrade my plan?

Sign in to your developer portal and click "Upgrade" to select a paid plan. You'll be redirected to Stripe checkout to complete payment. Your new limits apply immediately.

What payment methods do you accept?

We accept all major credit cards (Visa, Mastercard, American Express) through Stripe. Some regions may also support local payment methods.

Can I get a refund?

Monthly subscriptions are non-refundable for partial months, but you can cancel anytime and continue using the service until your billing period ends.

If you have concerns, contact us and we'll work with you.

Do you offer annual billing?

Not currently, but contact us if you're interested. We may offer annual plans with a discount in the future.

How do I cancel my subscription?

Sign in to your developer portal, click "Manage Billing", and cancel from the Stripe billing portal. Your access continues until the end of your current billing period.

Enterprise

Can I get higher limits?

Yes! Contact us for custom enterprise plans with higher rate limits, dedicated support, and custom SLAs.

Do you offer custom SLAs?

The Pro plan includes a 99.9% uptime SLA. For enterprise customers requiring higher guarantees or custom terms, contact us to discuss.

Is there dedicated support?

Pro plan customers receive priority email support. For enterprise customers, we offer dedicated support channels and faster response times. Contact us for details.

Still Have Questions?

We're here to help. Reach out and we'll get back to you quickly.

Contact Us