Sende deine Witze an GiggleTime

So funktioniert es

1. Erstelle ein kostenloses GiggleTime-Konto oder melde dich an.
2. Sag uns unter „Meine Einreichungen“, was du senden möchtest und ungefähr wie viele Witze.
3. Wir lesen jede Anfrage und antworten per E-Mail, meist innerhalb von ein, zwei Tagen.
4. Sobald du genehmigt bist, erstellst du auf derselben Seite deinen Schlüssel. Er wird nur einmal angezeigt, also bewahre ihn sicher auf.
5. Sende Witze mit einer einfachen HTTPS-Anfrage. Jeder wartet auf Prüfung, und du kannst seinen Status jederzeit abfragen.

So prüfen wir Witze

Jeder Witz, ob über die API oder das Formular auf unserer Website, wird vor der Veröffentlichung von einem Menschen gelesen. Die meisten werden innerhalb eines Tages geprüft.

Wir prüfen, ob er sich wie ein Witz liest, ob er in der gewählten Sprache ist und zu seiner Kategorie passt und ob er nicht schon in irgendeiner Sprache auf GiggleTime steht. Wir korrigieren eventuell einen Tippfehler oder verschieben einen Witz in eine passendere Kategorie.

Wenn wir einen Witz nicht verwenden können, sagen wir dir immer, warum: Der Grund steht unter „Meine Einreichungen“ und in der API. Genehmigte Witze erscheinen auf GiggleTime und sind in all unseren Sprachen lesbar.

Was wir annehmen

• Witze, die du selbst geschrieben hast, oder Witze, die frei geteilt werden dürfen, etwa überlieferte Witze und Folklore.
• Einzeiler, Witze mit Frage und Pointe, kurze Geschichten und Klopf-Klopf-Witze in jeder unserer 26 Sprachen.
• Witze, die du mit etwas Hilfe von KI geschrieben hast, sind in Ordnung, wenn du sie geprüft hast und sie gut sind. Massenhaft von KI erzeugte Witze nehmen wir nicht an.
• Kein Material, das von anderen Comedians, aus Büchern oder von Websites kopiert ist, kein Hass, keine Belästigung und keine Links oder Werbung.
• Markiere Witze für Erwachsene mit dem NSFW-Flag. Sie sind für Besucher ausgeblendet, die sie nicht eingeschaltet haben.

Grenzen

• Anfangs bis zu 20 Witze in 24 Stunden pro Schlüssel. Für Leute, deren Witze wir regelmäßig genehmigen, erhöhen wir das Limit.
• Höchstens 10 Witze pro Minute.
• Wenn unsere Prüfwarteschlange voll ist, werden neue Witze eine Weile abgelehnt. Bitte versuch es am nächsten Tag erneut.

API-Referenz

Alle Anfragen gehen an https://www.giggletime.app/api/v1/ und brauchen deinen Schlüssel im Authorization-Header:

Authorization: Bearer gtj_your_key

Aufrufe

Felder zum Senden eines Witzes

Beispiele

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": 17, "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": 17, "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: 17, 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());

Antworten

Ein angekommener Witz antwortet mit 201 und seiner ID. Er bleibt ausstehend, bis wir ihn geprüft haben:

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

Fehler antworten mit einem Code, auf den du reagieren kannst:

Status und Gründe

In GET /api/v1/jokes ist jeder Witz pending (ausstehend), approved (genehmigt, mit seiner URL) oder rejected (abgelehnt, mit Grundcode und dem Grund in der Sprache des Witzes):

Kategorien

• 17 Alltag
• 10 Arbeit
• 13 Beziehungen
• 12 Essen & Trinken
• 9 Familie
• 16 Geld
• 15 Gesundheit & Altern
• 5 Gruselig
• 2 Programmierung
• 11 Schule
• 3 Schwarz
• 7 Sonstiges
• 14 Technologie
• 8 Tiere
• 6 Weihnachten
• 4 Wortspiele

Sprachen

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 中文

Fragen

Kostet das etwas?

Nein. Die API ist kostenlos.

Wem gehören die Witze, die ich sende?

Du behältst alle Rechte, die du hast. Mit dem Senden eines Witzes erlaubst du GiggleTime, ihn zu veröffentlichen, zu übersetzen und in unseren Apps zu zeigen, wie es unsere Nutzungsbedingungen beschreiben. Nutzungsbedingungen

Kann ich einen Witz später entfernen?

Ja. Schreib uns, und wir nehmen ihn herunter. Kontakt

Was, wenn mein Schlüssel in falsche Hände gerät?

Erstelle unter „Meine Einreichungen“ einen neuen Schlüssel. Der alte funktioniert sofort nicht mehr.

Ich möchte lieber Witze auf meiner eigenen Website zeigen.

Dann probiere unser kostenloses „Witz des Tages“-Widget. Witz-Widget für deine Website