Developer

Limba: Română
Aspect

Tema

Culoarea de accent

Tema și culoarea te urmează pe satelit.md și în aplicație.

Intră

Pagini

Limba

Tema

Unde schimbi tema?

Alege unde se aplică tema nouă.

Poți schimba oricând din antet.

Bancuri

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

Credite
1 pentru fiecare 20 rânduri, 2 cu parametrul q
Cu cheie

Parametri

  • qstringopțional

    Cuvinte de căutat.

  • 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, otheropțional

    Tema actului.

  • kindstring: joke, riddle, proverb, quoteopțional

    Only this kind.

  • audiencestring: kids, family, general, adultopționalimplicit 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_ageintegeropțional

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

  • min_scoreintegeropțional

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

  • exclude_flagsstringopțional

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

  • pageintegeropționalimplicit 1

    Pagina, de la 1.

  • perintegeropționalimplicit 20

    Rânduri pe pagină, cel mult 20.

Erori posibile

Încearcă

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"]);
Răspuns
{
  "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.

Credite
1
Cu cheie

Parametri

  • 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, otheropțional

    Tema actului.

Erori posibile

Încearcă

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"]);
Răspuns
{
  "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.

Credite
1
Cu cheie

Parametri

  • 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, otheropțional

    Tema actului.

  • kindstring: joke, riddle, proverb, quoteopțional

    Only this kind.

  • audiencestring: kids, family, general, adultopționalimplicit 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_ageintegeropțional

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

  • min_scoreintegeropțional

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

  • exclude_flagsstringopțional

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

  • seenstringopțional

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

Erori posibile

Încearcă

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"]);
Răspuns
{
  "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.

Credite
1
Cu cheie

Parametri

  • audiencestring: kids, family, general, adultopționalimplicit 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`.

Erori posibile

Încearcă

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"]);
Răspuns
{
  "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.

Credite
1
Cu cheie

Parametri

  • idstringobligatoriu

    Identificatorul rândului.

Erori posibile

Încearcă

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"]);
Răspuns
{
  "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)"
  }
}