Skip to content
GET /v1/random

A random recipe

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/recipes-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/recipes-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/recipes-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/recipes-api/v1/random");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/recipes-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "id": "53005",
        "area": "British",
        "name": "Strawberry Rhubarb Pie",
        "tags": [
            "Pudding",
            "Pie",
            "Baking",
            "Fruity",
            "Glazed"
        ],
        "source": "https://www.joyofbaking.com/StrawberryRhubarbPie.html",
        "youtube": "https://www.youtube.com/watch?v=tGw5Pwm4YA0",
        "category": "Dessert",
        "thumbnail": "https://www.themealdb.com/images/media/meals/178z5o1585514569.jpg",
        "ingredients": [
            {
                "measure": "350g",
                "ingredient": "Flour"
            },
            {
                "measure": "1 tsp",
                "ingredient": "Salt"
            },
            {
                "measure": "2 tbs",
                "ingredient": "Sugar"
            },
            {
                "measure": "1 cup",
                "ingredient": "Butter"
            },
            {
                "measure": "1/2 cup",
                "ingredient": "Water"
            },
            {
                "measure": "450g",
                "ingredient": "Rhubarb"
            },
            {
                "measure": "450g",
                "ingredient": "Strawberries"
            },
            {
                "measure": "3 tbs",
                "ingredient": "Cornstarch"
            },
            {
                "measure": "150g",
                "ingredient": "Sugar"
            },
            {
                "measure": "1/4 tsp",
                "ingredient": "Cinnamon"
            },
            {
                "measure": "1 tsp",
                "ingredient": "Lemon Juice"
            },
            {
                "measure": "2 tbs",
                "ingredient": "Unsalted Butter"
            },
            {
                "measure": "2 tbs",
                "ingredient": "Milk"
            },
            {
                "measure": "Spinkling",
                "ingredient": "Sugar"
            }
        ],
        "instructions": "Pie Crust:  In a food processor, place the flour, salt, and sugar and process until combined. Add the butter and process until the mixture resembles coarse\r\n\r\nmeal (about 15 seconds). Pour 1/4 cup (60 ml) water in a slow, steady stream, through the feed tube until the dough just holds together when pinched. If necessary, add more water. Do not process more than 30 seconds.\r\nTurn the dough onto your work surface and gather into a ball. Divide the dough in half, flattening each half into a disk, cover with plastic wrap, and refrigerate for about one hour before using. This will chill the butter and relax the gluten in the flour. \r\n\r\nAfter the dough has chilled sufficiently, remove one portion of the dough from the fridge and place it on a lightly floured surface.  Roll the pastry into a 12 inch (30 cm) circle. (To prevent the pastry from sticking to the counter and to ensure uniform thickness, keep lifting up and turning the pastry a 
…