Recipes

The recipes

GET/v1/recipes

All the recipes, with the time and today's cost.

Credits: 2
: With a key

Parameters

No parameters.

Possible errors

curl "https://api.satelit.md/v1/recipes" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/recipes", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/recipes",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/recipes");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Response

{
  "data": [
    {
      "slug": "braised-cabbage-with-frankfurters",
      "title": "Braised cabbage with frankfurters",
      "servings": 4,
      "time_min": 45,
      "tags": [
        "one-pot"
      ],
      "cost_today": 36.44,
      "cost_per_serving": 9.11
    },
    {
      "slug": "red-borscht-with-beef",
      "title": "Red borscht with beef",
      "servings": 6,
      "time_min": 100,
      "tags": [
        "traditional",
        "soup"
      ],
      "cost_today": 64.44,
      "cost_per_serving": 10.74
    }
  ],
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Satelit",
        "url": "https://satelit.md",
        "license": "Satelit"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

One recipe

GET/v1/recipes/{slug}

The recipe, with ingredients and steps.

Credits: 1
: With a key

Parameters

slugstringrequired

The recipe name in the address.

Possible errors

Try it

curl "https://api.satelit.md/v1/recipes/braised-cabbage-with-frankfurters" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/recipes/braised-cabbage-with-frankfurters", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/recipes/braised-cabbage-with-frankfurters",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/recipes/braised-cabbage-with-frankfurters");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Response

{
  "data": {
    "slug": "braised-cabbage-with-frankfurters",
    "title": "Braised cabbage with frankfurters",
    "servings": 4,
    "time_min": 45,
    "tags": [
      "one-pot"
    ],
    "cost_today": 36.44,
    "cost_per_serving": 9.11,
    "ingredients": [
      {
        "name": "Cabbage",
        "qty": 1.2,
        "unit": "kg"
      },
      {
        "name": "Frankfurters",
        "qty": 0.5,
        "unit": "kg"
      },
      {
        "name": "Onions",
        "qty": 0.15,
        "unit": "kg"
      }
    ],
    "steps": [
      "Fry the chopped onion and grated carrot in oil for 5 minutes.",
      "Add the thinly sliced cabbage, salt and a glass of water. Cover and cook for 25 minutes."
    ]
  },
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Satelit",
        "url": "https://satelit.md",
        "license": "Satelit"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}