あなたのジョークをGiggleTimeへ

GiggleTimeは26言語のジョークサイトです。ジョークを書いている方、お笑いアカウントを運営している方、コレクションをお持ちの方は、自分のアプリやスクリプトから送ることができます。どのジョークも公開前に人が読みます。

APIリファレンスを見る

しくみ

無料のGiggleTimeアカウントを作成するか、ログインします。
「投稿したジョーク」で、送りたい内容とおおよその件数を教えてください。
すべての申請を読み、通常1〜2日以内にメールでお返事します。
承認されたら、同じページでキーを作成します。表示は一度きりなので、安全な場所に保管してください。
シンプルなHTTPSリクエストでジョークを送ります。それぞれ審査待ちになり、状況はいつでも確認できます。

ジョークの確認方法

APIからでもサイトのフォームからでも、すべてのジョークは公開前に人が読みます。ほとんどは1日以内に確認します。

ジョークとして読めるか、選んだ言語で書かれカテゴリに合っているか、すでにGiggleTimeにどの言語でもないかを確認します。誤字を直したり、より合うカテゴリに移したりすることがあります。

ジョークを採用できない場合は、必ず理由をお伝えします。理由は「投稿したジョーク」とAPIに表示されます。承認されたジョークはGiggleTimeに公開され、すべての言語で読めます。

受け付けるもの

自分で書いたジョーク、または昔話や民間伝承のような自由に共有できるジョーク。
一行ジョーク、問いと答えのジョーク、短い話、ノックノックジョークを、26言語のどれでも。
AIを少し手伝わせて書いたジョークは、確認済みで面白ければ問題ありません。AIで大量生成したジョークは受け付けません。
他のコメディアン、本、サイトからのコピー、ヘイトや嫌がらせ、リンクや広告は不可です。
大人向けのユーモアにはNSFWフラグを付けてください。オンにしていない訪問者には表示されません。

制限

最初はキーごとに24時間で最大20件。継続して承認されている投稿者は上限を引き上げます。
1分あたり最大10件。
審査待ちがいっぱいのときは、新しいジョークをしばらく受け付けません。翌日にもう一度お試しください。

APIリファレンス

すべてのリクエストは https://www.giggletime.app/api/v1/ に送り、Authorizationヘッダーにキーが必要です:

Authorization: Bearer gtj_your_key

呼び出し

`GET /api/v1/me`	あなたの上限と、過去24時間に送ったジョークの数。
`GET /api/v1/categories?language=en`	その言語でのカテゴリIDと名前、言語一覧、ジョークの種類。
`POST /api/v1/jokes`	ジョークを1件JSONで送ります。
`GET /api/v1/jokes`	あなたのジョークを新しい順にステータス付きで。任意:limit(最大100)と次のページ用の before_id。

ジョーク送信のフィールド

`language`	必須。言語コード(例:en、bg、es)。
`category_id`	必須。下の一覧または /api/v1/categories のカテゴリID。
`type`	必須。one-liner、setup-punchline、story、knock-knock のいずれか。
`setup`, `punchline`	問いと答えのジョークは、それぞれ最大300文字。
`text`	その他の種類:最大300文字、ストーリーは2000文字まで。
`author`	任意。ジョークのクレジット名、最大60文字。
`nsfw`	任意。大人向けのユーモアなら true。

例

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

レスポンス

受け付けたジョークは201とIDを返します。確認が終わるまでは審査待ちです:

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

エラーは対応の手がかりになるコードを返します:

`400`	`invalid_language`, `invalid_category`, `invalid_joke_type`, `missing_text`, `too_long`, `invalid_json`
`401`	`unauthorized`: キーがない、間違っている、または取り消されています。
`403`	`terms_required`: サイトにログインし、最新の規約に同意してください。 `account_suspended`
`409`	`duplicate_joke`: 同じジョークがすでにGiggleTimeにあります。
`429`	`too_fast`, `daily_limit`: しばらく待ってから再度お試しください。
`503`	`review_queue_full`: 翌日にもう一度お試しください。

ステータスと理由

GET /api/v1/jokes では、各ジョークは pending(審査待ち)、approved(承認、URL付き)、rejected(不承認、理由コードとジョークの言語での理由付き)のいずれかです:

`duplicate`	不承認:このジョークはすでにGiggleTimeにあります。
`not_a_joke`	不承認:ジョークとして読めません。
`wrong_language`	不承認:指定された言語の文章ではありません。
`offensive`	不承認:コンテンツガイドラインに違反しています。
`copied`	不承認:他のコメディアンのネタのようです。
`quality`	不承認:GiggleTimeに合いません。

言語

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

よくある質問

料金はかかりますか?

いいえ。APIは無料です。

送ったジョークの権利は誰のもの?

あなたの権利はそのままです。ジョークを送ることで、利用規約にあるとおり、GiggleTimeがそれを公開・翻訳し、アプリで表示することを許可したことになります。利用規約

あとからジョークを削除できますか?

はい。ご連絡いただければ取り下げます。お問い合わせ

キーが漏れたら?

「投稿したジョーク」で新しいキーを作成してください。古いキーはすぐに使えなくなります。

自分のサイトでジョークを表示したい。

それなら無料の「今日のジョーク」ウィジェットをお試しください。サイト用ジョークウィジェット

メニュー

言語

カテゴリー

設定