Search potions

Code snippets

curl "https://api.oanor.com/harrypotter-api/v1/potion" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/harrypotter-api/v1/potion", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/harrypotter-api/v1/potion");
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/harrypotter-api/v1/potion",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "page": 1,
        "count": 1,
        "total": 1,
        "potions": [
            {
                "id": "polyjuice-potion",
                "name": "Polyjuice Potion",
                "wiki": "https://harrypotter.fandom.com/wiki/Polyjuice_Potion",
                "image": "https://static.wikia.nocookie.net/harrypotter/images/1/1b/B2C12M2_Polyjuice_Potion_ready.jpg",
                "effect": "Allowed a human drinker to temporarily assume the form of another person",
                "inventors": null,
                "difficulty": "Advanced",
                "ingredients": "Lacewing flies (stewed for 21 days), Leeches, Powdered bicorn horn, Knotgrass, Fluxweed (picked at full moon), Shredded boomslang skin, A bit of the person one wanted to turn into (typically hair or toenails), Standard potioning water",
                "side_effects": "Attempts to transform into animals or part-humans would not reverse automatically",
                "characteristics": "Thick and mud-like, Bubbles slowly, Taste and colour varied depending on the person being turned into"
            }
        ],
        "page_size": 20
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:31.648Z",
        "request_id": "5302d4a0-3b26-46fc-8dc5-b8ff40171c9f"
    },
    "status": "ok",
    "message": "Potion retrieved",
    "success": true
}