GiggleTime GiggleTime
Menú
Mejorar a Premium Enviar un chiste Cómicos Sobre nosotros Preguntas frecuentes Contacto Añadir un cómico
Síguenos

Legal
Política de privacidad Términos de servicio Política de cookies Política de reembolso y cancelación Atribuciones
Iniciar sesión
Idioma
Categorías
Configuración
Idioma español
Modo seguro
Reproducción automática de chistes aleatorios
Notificaciones

Envía tus chistes a GiggleTime

GiggleTime es una web de chistes en 26 idiomas. Si escribes chistes, llevas una cuenta de humor o tienes una colección, puedes enviárnoslos desde tu propia app o script. Cada chiste lo lee una persona antes de publicarse.

Ver la referencia de la API

Cómo funciona

  1. Crea una cuenta gratuita de GiggleTime o inicia sesión.
  2. En Mis envíos, cuéntanos qué te gustaría enviar y, más o menos, cuántos chistes.
  3. Leemos cada solicitud y respondemos por correo, normalmente en uno o dos días.
  4. Una vez aprobado, crea tu clave en esa misma página. Solo se muestra una vez, así que guárdala en un lugar seguro.
  5. Envía chistes con una simple petición HTTPS. Cada uno espera revisión y puedes consultar su estado cuando quieras.

Cómo revisamos los chistes

Cada chiste, venga de la API o del formulario de nuestra web, lo lee una persona antes de publicarse. La mayoría se revisa en un día.

Comprobamos que se lea como un chiste, que esté en el idioma que elegiste y encaje en su categoría, y que no esté ya en GiggleTime en ningún idioma. Puede que corrijamos una errata o pasemos un chiste a una categoría mejor.

Si no podemos usar un chiste, siempre te decimos por qué: el motivo aparece en Mis envíos y en la API. Los chistes aprobados se publican en GiggleTime y se pueden leer en todos nuestros idiomas.

Qué aceptamos

  • Chistes que escribiste tú, o chistes de libre uso, como los chistes tradicionales y el folclore.
  • Chistes de una línea, de pregunta y respuesta, historias cortas y chistes de toc toc, en cualquiera de nuestros 26 idiomas.
  • Los chistes que escribiste con algo de ayuda de la IA están bien si los revisaste y son buenos. No aceptamos chistes generados por IA en masa.
  • Nada de material copiado de otros cómicos, libros o webs, nada de odio ni acoso, y sin enlaces ni publicidad.
  • Marca el humor para adultos con la opción NSFW. Se oculta a los visitantes que no la han activado.

Límites

  • Al principio, hasta 20 chistes en 24 horas por clave. Subimos el límite a quienes aprobamos chistes con regularidad.
  • Como máximo 10 chistes por minuto.
  • Cuando nuestra cola de revisión está llena, los chistes nuevos se rechazan durante un tiempo. Vuelve a intentarlo al día siguiente.

Referencia de la API

Todas las peticiones van a https://www.giggletime.app/api/v1/ y necesitan tu clave en la cabecera Authorization:

Authorization: Bearer gtj_your_key

Llamadas

GET /api/v1/meTus límites y cuántos chistes has enviado en las últimas 24 horas.
GET /api/v1/categories?language=enIds y nombres de las categorías en ese idioma, los idiomas y los tipos de chiste.
POST /api/v1/jokesEnvía un chiste en JSON.
GET /api/v1/jokesTus chistes, los más nuevos primero, con su estado. Opcional: limit (hasta 100) y before_id para la página siguiente.

Campos para enviar un chiste

languageObligatorio. El código del idioma, por ejemplo en, bg o es.
category_idObligatorio. Un id de categoría de la lista de abajo o de /api/v1/categories.
typeObligatorio. one-liner, setup-punchline, story o knock-knock.
setup, punchlinePara chistes de pregunta y respuesta, hasta 300 caracteres cada parte.
textPara los demás tipos: hasta 300 caracteres, o 2000 para las historias.
authorOpcional. A quién se atribuye el chiste, hasta 60 caracteres.
nsfwOpcional. true para humor para adultos.

Ejemplos

curl

curl -X POST https://www.giggletime.app/api/v1/jokes \
  -H "Authorization: Bearer gtj_your_key" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "category_id": 8, "type": "setup-punchline",
       "setup": "Why did the scarecrow win an award?",
       "punchline": "He was outstanding in his field."}'

Python

import requests

r = requests.post("https://www.giggletime.app/api/v1/jokes",
    headers={"Authorization": "Bearer gtj_your_key"},
    json={"language": "en", "category_id": 8, "type": "one-liner",
          "text": "I told my wife she draws her eyebrows too high. She looked surprised."})
print(r.status_code, r.json())

JavaScript

const r = await fetch("https://www.giggletime.app/api/v1/jokes", {
  method: "POST",
  headers: { "Authorization": "Bearer gtj_your_key", "Content-Type": "application/json" },
  body: JSON.stringify({ language: "en", category_id: 8, type: "one-liner",
    text: "I'm reading a book about anti-gravity. It's impossible to put down." })
});
console.log(r.status, await r.json());

Respuestas

Un chiste recibido responde 201 con su id. Queda pendiente hasta que lo revisemos:

{"id": 1830, "status": "pending", "remaining_today": 19}

Los errores responden con un código con el que puedes actuar:

400invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json
401unauthorized: la clave falta, es incorrecta o se ha revocado.
403terms_required: inicia sesión en la web y acepta las condiciones vigentes. account_suspended
409duplicate_joke: el mismo chiste ya está en GiggleTime.
429too_fast, daily_limit: espera y vuelve a intentarlo más tarde.
503review_queue_full: vuelve a intentarlo al día siguiente.

Estados y motivos

En GET /api/v1/jokes cada chiste está pending (pendiente), approved (aprobado, con su url) o rejected (rechazado, con un código y el motivo en el idioma del chiste):

duplicateNo aprobado: este chiste ya está en GiggleTime.
not_a_jokeNo aprobado: esto no parece un chiste.
wrong_languageNo aprobado: el texto no está en el idioma indicado.
offensiveNo aprobado: incumple nuestras normas de contenido.
copiedNo aprobado: parece material de otro cómico.
qualityNo aprobado: no encaja en GiggleTime.

Categorías

  • 8 Animales
  • 12 Comida y Bebida
  • 16 Dinero
  • 11 Escuela
  • 5 Espeluznante
  • 9 Familia
  • 4 Juego de palabras
  • 6 Navidad
  • 3 Oscuro
  • 2 Programación
  • 13 Relaciones
  • 15 Salud y Envejecimiento
  • 14 Tecnología
  • 10 Trabajo
  • 7 Varios
  • 17 Vida Cotidiana

Idiomas

ar العربية bg Български ca Català cs česky cy Cymraeg da dansk de Deutsch el Ελληνικά en English es español et eesti, eesti keel fr français hi हिन्दी, हिंदी id Bahasa Indonesia it Italiano ja 日本語 ka ქართული nl Nederlands, Vlaams pl polski pt Português ru Русский sv svenska tr Türkçe uk Українська vi Tiếng Việt zh 中文

Preguntas

¿Cuesta algo?

No. La API es gratuita.

¿De quién son los chistes que envío?

Conservas los derechos que tengas. Al enviar un chiste permites que GiggleTime lo publique, lo traduzca y lo muestre en nuestras apps, como describen nuestras condiciones. Términos de servicio

¿Puedo retirar un chiste más tarde?

Sí. Escríbenos y lo retiraremos. Contacto

¿Y si se filtra mi clave?

Crea una clave nueva en Mis envíos. La anterior deja de funcionar al instante.

Prefiero mostrar chistes en mi propia web.

Entonces prueba nuestro widget gratuito del chiste del día. Widget de chistes para tu web