Recipe API

Usage Guide

Get delicious recipes with our powerful API. Here's how to get started:

Basic Usage


                            https://placehold.cloud/r

This request will return random recipes from our database.

Query Parameters

query: Search query for recipes (optional)
category: Recipe category (optional)
area: Recipe area/cuisine (optional)
number: Number of recipes to return (1-25, default: 10) (optional)

Response Format

{
    "status": "success",
    "data": [
        {
            "id": "recipe_id",
            "title": "Recipe Title",
            "image": "Image URL",
            "category": "Recipe Category",
            "area": "Recipe Area",
            "instructions": "Cooking Instructions",
            "sourceUrl": "Source URL",
            "youtubeUrl": "YouTube URL",
            "ingredients": [
                {
                    "ingredient": "Ingredient Name",
                    "measure": "Measurement"
                },
                // ... more ingredients
            ]
        },
        // ... more recipes
    ],
    "timestamp": "YYYY-MM-DD HH:MM:SS"
}

Example Usage

Here's an example of how to use the API with parameters:


                            https://placehold.cloud/r?number=5&category=Dessert

This request will return 5 random dessert recipes.

Error Handling

In case of an error, the API will return a JSON response with an error message:

{
    "status": "error",
    "message": "Error description"
}

API Limits

To ensure fair usage, this API is rate-limited. Please adhere to the following limits:

60 requests per minute
1000 requests per day