API リファレンス

レート制限 (Rate Limits)

すべてのレスポンスには、レート制限を追跡し尊重するのに役立つ以下のヘッダーが含まれています:

ヘッダー	説明
x-rate-limit-limit	現在のレート制限ウィンドウの期間（例: 1m）
x-rate-limit-remaining	現在のウィンドウ内の残りリクエスト数
x-rate-limit-reset	現在のウィンドウがリセットされる ISO 8601 タイムスタンプ

制限値

エンドポイント	制限
/search	5秒あたり 7 リクエスト
/:category	1分あたり 200 リクエスト（カテゴリごと）

User-Agent

すべてのリクエストには User-Agent ヘッダーを含める必要があります。次の形式を使用してください: アプリ名 (連絡先情報)
例: NekoApp (https://example.com) または NekoApp (dev@example.com)

命名ガイドライン:

• 具体的に指定する: 「Discord Bot」、「WhatsApp Bot」、「Telegram Bot」のような汎用的な名前を使用しないでください。アプリケーションには一意の名前が必要です。
• プレースホルダーを避ける: test、bot、または上記の例の値のような文字列を使用しないでください。
• ライブラリのデフォルト値を使用しない: python-requests、okhttp、axios、node、Go-http-client などのデフォルトのライブラリ文字列の使用を避けてください。

連絡先情報のオプション:
連絡先情報は伝統的なウェブサイトである必要はありません。識別情報を提供する方法として、以下のいずれも受け入れられます:

• 直接連絡可能なメールアドレス。
• プロジェクトのウェブサイトまたは公開リポジトリの URL（例: GitHub、GitLab）。
• ボットの招待リンクまたはディスカバリーページ。
• リスティング URL（例: top.gg や同様のディレクトリ）。

なりすましとスプーフィング:

• ブラウザ文字列を偽装しないでください。 Mozilla/5.0 ... 形式は、本物のウェブブラウザおよび Cloudflare によって認証されたボット専用に厳密に予約されています。
• クローラー（Googlebot や Bingbot など）になりすまさないでください。

これらのガイドラインに従わなかったり、汎用的、デフォルト、または偽装された値を使用した場合、リクエストがブロックされる可能性が高いです。

カテゴリ

カテゴリは API によって返されるコンテンツのタイプを定義します。各カテゴリは固定のファイル形式にマッピングされます。

画像

husbandokitsunenekowaifu

GIF

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

レスポンスフィールド

タイプ	フィールド
画像	artist_name, artist_href, source_url
GIF	anime_name

url と dimensions は両方に含まれます。