🔌 API publique blagueurs.com

Accédez gratuitement aux blagues en JSON. Parfait pour vos applications, bots Discord, assistants vocaux... Limite : 60 requêtes/heure par IP.

🎲 Blague aléatoire

GET


            https://www.blagueurs.com/api/v1.php?action=aleatoire

Paramètre	Type	Description
`cat`	optionnel	ID de catégorie (voir /api/v1.php?action=categories)

Tester →

🏆 Top blagues

GET


            https://www.blagueurs.com/api/v1.php?action=top

Paramètre	Type	Description
`limit`	optionnel	Nombre de résultats (max 50, défaut 10)
`cat`	optionnel	ID de catégorie

Tester →

🔍 Une blague par ID

GET


            https://www.blagueurs.com/api/v1.php?action=blague&id=

Paramètre	Type	Description
`id`	requis	ID de la blague

Tester →

📂 Liste des catégories

GET


            https://www.blagueurs.com/api/v1.php?action=categories

Tester →

🔎 Recherche

GET


            https://www.blagueurs.com/api/v1.php?action=recherche&q=

Paramètre	Type	Description
`q`	requis	Terme de recherche (min. 2 caractères)
`limit`	optionnel	Nombre de résultats (max 20, défaut 10)

Tester →

📄 Exemple de réponse

{
  "succes": true,
  "blague": {
    "id": 42,
    "titre": "Le Belge et son GPS",
    "contenu": "Un Belge conduit avec son GPS...",
    "categorie": "Belges",
    "auteur": "admin",
    "nb_likes": 127,
    "nb_vues": 3840,
    "date": "2026-01-04 09:10:00",
    "url": "https://www.blagueurs.com/blague/42"
  }
}

⚠️ Conditions d'utilisation

Utilisation gratuite pour projets personnels et non-commerciaux
Mentionnez blagueurs.com comme source dans votre projet
Pas de revente des données
Limite : 60 requêtes/heure par IP