Developer

Language: English
Appearance

Theme

Accent colour

Your theme and colour carry over to satelit.md and the app.

Sign in

Pages

Language

Theme

Where should the theme change?

Choose where the new theme applies.

You can change it any time from the header.

Jokes

Jokes, funniest first

GET/v1/jokes

Jokes rated and translated once by a model: how funny (`score`), how well they land in Moldova (`md_score`), from what age (`min_age`), whether a child may hear it (`kids_ok`), 18+ (`adult`), what they contain (`flags`) and their topics. The text is in the request's language, and a joke whose point is lost there is not listed in it (`langs` says where it works). Funniest first. `q` matches every word in any language's text or a topic's name, and any word when no joke has them all. Costs 1 credit per 20 rows, 2 with `q`.

Credits
1 for every 20 rows, 2 with the q parameter
With a key

Parameters

  • qstringoptional

    Words to search for.

  • topicstring: family, couples, kids, school, work, doctors, police, animals, money, drinking, food, tech, travel, sport, old_age, mother_in_law, neighbours, village, army, law, religion, politics, bula, ion_maria, blondes, regions, wordplay, dark, otheroptional

    The act's topic.

  • kindstring: joke, riddle, proverb, quoteoptional

    Only this kind.

  • audiencestring: kids, family, general, adultoptionaldefault general

    Who will hear it. `kids`: fit for a child (under 12), up to `max_age` (6 without it). `family`: fit for a child, read out to the whole family. `general` (default): no 18+. `adult`: 18+ too. A joke mocking a people is in `general` and `adult`: leave it out with `exclude_flags=ethnic`.

  • max_ageintegeroptional

    Only jokes that suit a listener this young: `min_age` at or under it.

  • min_scoreintegeroptional

    Only jokes at or above this score (0-100, how funny). Without it 40 for `kids`, 50 for the rest.

  • exclude_flagsstringoptional

    A comma list of flags to leave out, such as `alcohol,politics`.

  • pageintegeroptionaldefault 1

    The page, starting at 1.

  • perintegeroptionaldefault 20

    Rows per page, at most 20.

Possible errors

Try it

curl "https://api.satelit.md/v1/jokes" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/jokes", {
  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/jokes",
    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/jokes");
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": [
    {
      "id": "j_1207",
      "kind": "joke",
      "title": "A short memory",
      "text": "- Doctor, I forget everything.\n- Since when?\n- Since when what?",
      "lang": "en",
      "topic": "doctors",
      "topics": [
        "doctors"
      ],
      "score": 80,
      "md_score": 80,
      "min_age": 9,
      "kids_ok": true,
      "adult": false,
      "flags": [],
      "langs": [
        "ro",
        "ru",
        "en",
        "uk"
      ],
      "source": {
        "name": "Râzi cu lacrimi",
        "url": "https://raziculacrimi.ro/bancuri/"
      },
      "published_at": "2026-11-02T13:05:00+02:00",
      "voice": [
        {
          "speaker": "narrator",
          "text": "A patient comes to the doctor."
        },
        {
          "speaker": "male",
          "text": "Doctor, I forget everything."
        },
        {
          "speaker": "female",
          "text": "Since when?"
        },
        {
          "speaker": "male",
          "text": "Since when what?"
        }
      ],
      "dialogue": true
    }
  ],
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Râzi cu lacrimi",
        "url": "https://raziculacrimi.ro/bancuri/",
        "license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)",
    "page": {
      "page": 1,
      "per": 20,
      "total": 240,
      "pages": 12
    }
  }
}

The joke of the day

GET/v1/jokes/today

One joke for the whole Chisinau day, the same in every answer and language: a family joke that works in all four languages, not the day's joke again within a year. With `topic`, the day's joke of that topic. Costs 1 credit.

Credits
1
With a key

Parameters

  • topicstring: family, couples, kids, school, work, doctors, police, animals, money, drinking, food, tech, travel, sport, old_age, mother_in_law, neighbours, village, army, law, religion, politics, bula, ion_maria, blondes, regions, wordplay, dark, otheroptional

    The act's topic.

Possible errors

Try it

curl "https://api.satelit.md/v1/jokes/today" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/jokes/today", {
  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/jokes/today",
    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/jokes/today");
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": {
    "id": "j_1207",
    "kind": "joke",
    "title": "A short memory",
    "text": "- Doctor, I forget everything.\n- Since when?\n- Since when what?",
    "lang": "en",
    "topic": "doctors",
    "topics": [
      "doctors"
    ],
    "score": 80,
    "md_score": 80,
    "min_age": 9,
    "kids_ok": true,
    "adult": false,
    "flags": [],
    "langs": [
      "ro",
      "ru",
      "en",
      "uk"
    ],
    "source": {
      "name": "Râzi cu lacrimi",
      "url": "https://raziculacrimi.ro/bancuri/"
    },
    "published_at": "2026-11-02T13:05:00+02:00",
    "voice": [
      {
        "speaker": "narrator",
        "text": "A patient comes to the doctor."
      },
      {
        "speaker": "male",
        "text": "Doctor, I forget everything."
      },
      {
        "speaker": "female",
        "text": "Since when?"
      },
      {
        "speaker": "male",
        "text": "Since when what?"
      }
    ],
    "dialogue": true,
    "date": "2026-11-05"
  },
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Râzi cu lacrimi",
        "url": "https://raziculacrimi.ro/bancuri/",
        "license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

A joke not yet shown

GET/v1/jokes/random

One joke among the funniest that fit the filters and none of `seen`: what an app tells a user who asks for another, without repeating itself. 404 when every one that fits was seen. Costs 1 credit.

Credits
1
With a key

Parameters

  • topicstring: family, couples, kids, school, work, doctors, police, animals, money, drinking, food, tech, travel, sport, old_age, mother_in_law, neighbours, village, army, law, religion, politics, bula, ion_maria, blondes, regions, wordplay, dark, otheroptional

    The act's topic.

  • kindstring: joke, riddle, proverb, quoteoptional

    Only this kind.

  • audiencestring: kids, family, general, adultoptionaldefault general

    Who will hear it. `kids`: fit for a child (under 12), up to `max_age` (6 without it). `family`: fit for a child, read out to the whole family. `general` (default): no 18+. `adult`: 18+ too. A joke mocking a people is in `general` and `adult`: leave it out with `exclude_flags=ethnic`.

  • max_ageintegeroptional

    Only jokes that suit a listener this young: `min_age` at or under it.

  • min_scoreintegeroptional

    Only jokes at or above this score (0-100, how funny). Without it 40 for `kids`, 50 for the rest.

  • exclude_flagsstringoptional

    A comma list of flags to leave out, such as `alcohol,politics`.

  • seenstringoptional

    Ids already shown to this user, comma separated, at most 200.

Possible errors

Try it

curl "https://api.satelit.md/v1/jokes/random" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/jokes/random", {
  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/jokes/random",
    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/jokes/random");
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": {
    "id": "j_1207",
    "kind": "joke",
    "title": "A short memory",
    "text": "- Doctor, I forget everything.\n- Since when?\n- Since when what?",
    "lang": "en",
    "topic": "doctors",
    "topics": [
      "doctors"
    ],
    "score": 80,
    "md_score": 80,
    "min_age": 9,
    "kids_ok": true,
    "adult": false,
    "flags": [],
    "langs": [
      "ro",
      "ru",
      "en",
      "uk"
    ],
    "source": {
      "name": "Râzi cu lacrimi",
      "url": "https://raziculacrimi.ro/bancuri/"
    },
    "published_at": "2026-11-02T13:05:00+02:00",
    "voice": [
      {
        "speaker": "narrator",
        "text": "A patient comes to the doctor."
      },
      {
        "speaker": "male",
        "text": "Doctor, I forget everything."
      },
      {
        "speaker": "female",
        "text": "Since when?"
      },
      {
        "speaker": "male",
        "text": "Since when what?"
      }
    ],
    "dialogue": true
  },
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Râzi cu lacrimi",
        "url": "https://raziculacrimi.ro/bancuri/",
        "license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

Joke topics

GET/v1/jokes/topics

Every topic with jokes for this audience in the request's language, with its name and how many, most first. Costs 1 credit.

Credits
1
With a key

Parameters

  • audiencestring: kids, family, general, adultoptionaldefault general

    Who will hear it. `kids`: fit for a child (under 12), up to `max_age` (6 without it). `family`: fit for a child, read out to the whole family. `general` (default): no 18+. `adult`: 18+ too. A joke mocking a people is in `general` and `adult`: leave it out with `exclude_flags=ethnic`.

Possible errors

Try it

curl "https://api.satelit.md/v1/jokes/topics" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/jokes/topics", {
  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/jokes/topics",
    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/jokes/topics");
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": [
    {
      "key": "doctors",
      "name": "Doctors",
      "count": 41
    }
  ],
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Râzi cu lacrimi",
        "url": "https://raziculacrimi.ro/bancuri/",
        "license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

One joke

GET/v1/jokes/{id}

A joke with its title and text in every language its point works in. Costs 1 credit.

Credits
1
With a key

Parameters

  • idstringrequired

    The row identifier.

Possible errors

Try it

curl "https://api.satelit.md/v1/jokes/{id}" \
  -H "Authorization: Bearer $SATELIT_KEY"
const res = await fetch("https://api.satelit.md/v1/jokes/{id}", {
  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/jokes/{id}",
    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/jokes/{id}");
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": {
    "id": "j_1207",
    "kind": "joke",
    "title": "A short memory",
    "text": "- Doctor, I forget everything.\n- Since when?\n- Since when what?",
    "lang": "en",
    "topic": "doctors",
    "topics": [
      "doctors"
    ],
    "score": 80,
    "md_score": 80,
    "min_age": 9,
    "kids_ok": true,
    "adult": false,
    "flags": [],
    "langs": [
      "ro",
      "ru",
      "en",
      "uk"
    ],
    "source": {
      "name": "Râzi cu lacrimi",
      "url": "https://raziculacrimi.ro/bancuri/"
    },
    "published_at": "2026-11-02T13:05:00+02:00",
    "voice": [
      {
        "speaker": "narrator",
        "text": "A patient comes to the doctor."
      },
      {
        "speaker": "male",
        "text": "Doctor, I forget everything."
      },
      {
        "speaker": "female",
        "text": "Since when?"
      },
      {
        "speaker": "male",
        "text": "Since when what?"
      }
    ],
    "dialogue": true,
    "texts": {
      "en": {
        "title": "A short memory",
        "text": "- Doctor, I forget everything.\n- Since when?\n- Since when what?"
      }
    }
  },
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Râzi cu lacrimi",
        "url": "https://raziculacrimi.ro/bancuri/",
        "license": "none: read from the source's public pages; no agreement with the source and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}