Jokes API logo
EntretenimientoMANTENIDA1 token / llamada

Jokes API

252 chistes originales y limpios en 12 categorías, aleatorios, buscables y aptos para cualquier público

252 chistes originales y aptos para todo publico — de una linea y de dos partes (planteamiento y remate) — en 12 categorias: papa, juegos de palabras, programacion, general, animales, comida, ciencia, trabajo, escuela, musica, deportes y espacio. Obten chistes al azar (hasta 20 a la vez), busca texto en todo el catalogo, filtra por categoria o tipo, recorrelos con paginacion o pide uno por id. Todos los chistes fueron escritos para esta API y son aptos para el trabajo (safe: true), listos para apps, chatbots, dashboards, bots de Slack y juegos para cualquier audiencia.

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 1 token por llamada, así que el plan gratuito cubre unas 500 llamadas al mes.

Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras
response.json
{
  "query": "GET /v1/jokes/random?category=space",
  "setup": "How do you organize a space party?",
  "delivery": "You planet.",
  "catalog": "252 original SFW jokes / 12 categories"
}
Listo para producción
Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla
REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs
Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de Jokes API

  • Añadir el chiste del día a un chatbot, un panel o una app infantil.

  • Rellenar pantallas de carga y estados vacíos con un chiste corto y seguro.

  • Construir un feed de chistes por categoría, de chistes de padre a humor de programación.

  • Obtener hasta 20 chistes aleatorios a la vez para un mazo de cartas o un cuestionario.

Endpoints de Jokes API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

GETGet Joke

https://api-jokes.dataandapis.com/v1/jokes/{id}

Parámetros de ruta

ParámetroEjemplo
id1Obligatorio

Petición de ejemplo

curl "https://api-jokes.dataandapis.com/v1/jokes/1" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "id": 96,
  "type": "single",
  "category": "programming",
  "joke": "A byte walks into a bar looking miserable. The bartender asks what's wrong. 'Parity error.' 'Yeah, you look a bit off.'",
  "safe": true
}

GETList Categories

https://api-jokes.dataandapis.com/v1/jokes/categories

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://api-jokes.dataandapis.com/v1/jokes/categories" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "count": 12,
  "total_jokes": 252,
  "categories": [
    {
      "name": "animal",
      "jokes": 21
    },
    {
      "name": "dad",
      "jokes": 32
    },
    {
      "name": "food",
      "jokes": 20
    },
    {
      "name": "general",
      "jokes": 31
    },
    {
      "name": "music",
      "jokes": 12
    },
    {
      "name": "programming",
      "jokes": 38
…
Ver la respuesta completa
{
  "ok": true,
  "count": 12,
  "total_jokes": 252,
  "categories": [
    {
      "name": "animal",
      "jokes": 21
    },
    {
      "name": "dad",
      "jokes": 32
    },
    {
      "name": "food",
      "jokes": 20
    },
    {
      "name": "general",
      "jokes": 31
    },
    {
      "name": "music",
      "jokes": 12
    },
    {
      "name": "programming",
      "jokes": 38
    },
    {
      "name": "pun",
      "jokes": 31
    },
    {
      "name": "school",
      "jokes": 12
    },
    {
      "name": "science",
      "jokes": 16
    },
    {
      "name": "space",
      "jokes": 12
    },
    {
      "name": "sports",
      "jokes": 12
    },
    {
      "name": "work",
      "jokes": 15
    }
  ]
}

GETList Jokes

https://api-jokes.dataandapis.com/v1/jokes

Parámetros de consulta

ParámetroEjemplo
categoryprogrammingOpcional
limit20Opcional
page1Opcional
searchcheeseOpcional
typesingleOpcional

Petición de ejemplo

curl "https://api-jokes.dataandapis.com/v1/jokes?category=programming&limit=20&page=1&search=cheese&type=single" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "total": 38,
  "page": 1,
  "limit": 2,
  "count": 2,
  "results": [
    {
      "id": 21,
      "type": "twopart",
      "category": "programming",
      "setup": "Why do programmers prefer dark mode?",
      "delivery": "Because light attracts bugs.",
      "safe": true
    },
    {
      "id": 22,
      "type": "single",
      "category": "programming",
      "joke": "There are 10 kinds of people: those who understand binary and those who don't.",
      "safe": true
    }
  ]
}

GETRandom Joke

https://api-jokes.dataandapis.com/v1/jokes/random

Parámetros de consulta

ParámetroEjemplo
amount1Opcional
categorydadOpcional
searchOpcional
typetwopartOpcional

Petición de ejemplo

curl "https://api-jokes.dataandapis.com/v1/jokes/random?amount=1&category=dad&type=twopart" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "count": 1,
  "results": [
    {
      "id": 241,
      "type": "twopart",
      "category": "space",
      "setup": "How do you organize a space party?",
      "delivery": "You planet.",
      "safe": true
    }
  ]
}

De dónde salen los datos

Fuente
Conjunto de chistes originales incluido en el worker.
Actualización
Ampliado con las versiones de la API.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes
4endpoints
RESTarquitectura
1clave para todas las APIs
  • Respuestas totalmente tipadas — autocompletado en tu IDE
  • Sigue la API al día — los nuevos endpoints llegan el mismo día
  • Una sola clave funciona en más de 125 APIs de la plataforma
import axios from 'axios';

const { data } = await axios.get(
  'https://api-jokes.dataandapis.com/v1/jokes/{id}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Jokes API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key

Parámetros de ruta

id
import axios from 'axios';

const url = 'https://api-jokes.dataandapis.com/v1/jokes/{id}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte comunitario
Comienza gratis
Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email
Suscribirse

PRO

$24.99/mes

100.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email prioritario
Suscribirse

ULTRA

$99.99/mes

1.000.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte prioritario
Suscribirse

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

Preguntas sobre Jokes API

Lanza Jokes API esta tarde.

500 tokens gratis. Sin tarjeta. Y más de 125 APIs más con la misma clave.