Developer

Язык: Русский
Оформление

Тема

Цвет акцента

Тема и цвет сохранятся на satelit.md и в приложении.

Войти

Страницы

Язык

Тема

Где сменить тему?

Выберите, где применить новую тему.

Изменить можно в любой момент в шапке.

Анекдоты

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`.

Кредиты
1 за блок строк: 20, 2 с параметром 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необязательныйпо умолчанию 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_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.

Кредиты
1
С ключом

Параметры

  • 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.

Кредиты
1
С ключом

Параметры

  • 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необязательныйпо умолчанию 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_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.

Кредиты
1
С ключом

Параметры

  • audiencestring: kids, family, general, adultнеобязательныйпо умолчанию 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`.

Возможные ошибки

Попробовать

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.

Кредиты
1
С ключом

Параметры

  • 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)"
  }
}