Анекдоти
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`.
Параметри
-
qstringнеобов'язковийСлова для пошуку.
-
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, otherнеобов'язковийТема акта.
-
kindstring: joke, riddle, proverb, quoteнеобов'язковийOnly this kind.
-
audiencestring: kids, family, general, adultнеобов'язковийза замовчуванням generalWho 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_ageintegerнеобов'язковийOnly jokes that suit a listener this young: `min_age` at or under it.
-
min_scoreintegerнеобов'язковийOnly jokes at or above this score (0-100, how funny). Without it 40 for `kids`, 50 for the rest.
-
exclude_flagsstringнеобов'язковийA comma list of flags to leave out, such as `alcohol,politics`.
-
pageintegerнеобов'язковийза замовчуванням 1Сторінка, починаючи з 1.
-
perintegerнеобов'язковийза замовчуванням 20Рядків на сторінку, щонайбільше 20.
Можливі помилки
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"]); {
"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.
Параметри
-
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, otherнеобов'язковийТема акта.
Можливі помилки
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"]); {
"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.
Параметри
-
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, otherнеобов'язковийТема акта.
-
kindstring: joke, riddle, proverb, quoteнеобов'язковийOnly this kind.
-
audiencestring: kids, family, general, adultнеобов'язковийза замовчуванням generalWho 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_ageintegerнеобов'язковийOnly jokes that suit a listener this young: `min_age` at or under it.
-
min_scoreintegerнеобов'язковийOnly jokes at or above this score (0-100, how funny). Without it 40 for `kids`, 50 for the rest.
-
exclude_flagsstringнеобов'язковийA comma list of flags to leave out, such as `alcohol,politics`.
-
seenstringнеобов'язковийIds already shown to this user, comma separated, at most 200.
Можливі помилки
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"]); {
"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.
Параметри
-
audiencestring: kids, family, general, adultнеобов'язковийза замовчуванням generalWho 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`.
Можливі помилки
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"]); {
"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.
Параметри
-
idstringобов'язковийІдентифікатор рядка.
Можливі помилки
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"]); {
"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)"
}
}