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.
Cómo funciona
- Crea una cuenta gratuita de GiggleTime o inicia sesión.
- En Mis envíos, cuéntanos qué te gustaría enviar y, más o menos, cuántos chistes.
- Leemos cada solicitud y respondemos por correo, normalmente en uno o dos días.
- Una vez aprobado, crea tu clave en esa misma página. Solo se muestra una vez, así que guárdala en un lugar seguro.
- 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/me | Tus límites y cuántos chistes has enviado en las últimas 24 horas. |
GET /api/v1/categories?language=en | Ids y nombres de las categorías en ese idioma, los idiomas y los tipos de chiste. |
POST /api/v1/jokes | Envía un chiste en JSON. |
GET /api/v1/jokes | Tus 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
language | Obligatorio. El código del idioma, por ejemplo en, bg o es. |
category_id | Obligatorio. Un id de categoría de la lista de abajo o de /api/v1/categories. |
type | Obligatorio. one-liner, setup-punchline, story o knock-knock. |
setup, punchline | Para chistes de pregunta y respuesta, hasta 300 caracteres cada parte. |
text | Para los demás tipos: hasta 300 caracteres, o 2000 para las historias. |
author | Opcional. A quién se atribuye el chiste, hasta 60 caracteres. |
nsfw | Opcional. 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:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: la clave falta, es incorrecta o se ha revocado. |
403 | terms_required: inicia sesión en la web y acepta las condiciones vigentes. account_suspended |
409 | duplicate_joke: el mismo chiste ya está en GiggleTime. |
429 | too_fast, daily_limit: espera y vuelve a intentarlo más tarde. |
503 | review_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):
duplicate | No aprobado: este chiste ya está en GiggleTime. |
not_a_joke | No aprobado: esto no parece un chiste. |
wrong_language | No aprobado: el texto no está en el idioma indicado. |
offensive | No aprobado: incumple nuestras normas de contenido. |
copied | No aprobado: parece material de otro cómico. |
quality | No aprobado: no encaja en GiggleTime. |
Categorías
8Animales12Comida y Bebida16Dinero11Escuela5Espeluznante9Familia4Juego de palabras6Navidad3Oscuro2Programación13Relaciones15Salud y Envejecimiento14Tecnología10Trabajo7Varios17Vida 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