オープンインターフェース

オープン API

ブランドのメタデータ、SVG ソース、ラスター画像をそのまま取得できます。すべて読み取り専用の公開 API で、登録や API キーは不要です。

エンドポイントHTTPS · GET

https://logohub.afengblog.com/api

application/json; charset=utf-8 を返します。送信元 IP ごとに毎秒 20 リクエストまで

エンドポイント一覧

GET https://logohub.afengblog.com/api/search?q=&category=&sort=&order=&limit=&offset=&lang=キーワード検索。中国語名（簡体字・繁体字）、英語名、ピンイン、ピンインの頭文字に対応。q は必須、1 回最大 20 件。sort は latest / name、order は asc / desc（既定は更新日が新しい順、名前が A→Z）

GET https://logohub.afengblog.com/api/logos/:slug?lang=1 件のブランドのメタデータ。SVG ソース、アセット URL、同じカテゴリのロゴを含みます

GET https://logohub.afengblog.com/api/logos?q=&category=&sort=&order=&limit=&offset=&lang=一覧と絞り込み。既定では SVG ソースを含みません。limit の上限は 20

GET https://logohub.afengblog.com/api/stats収録総数、カテゴリ別件数、最終登録日時

GET https://logohub.afengblog.com/api/healthサービスとデータベースの状態。データベースの準備ができていない場合は 503

多言語

検索、一覧、詳細の各 API は任意パラメーター lang を受け付けます。値は zh-CN / zh-TW / ja / en（大文字小文字を区別しません）、既定は zh-CN です。

localeレスポンスの最上位と各項目に含まれ、返された内容の言語版を示します

name, enNameその言語での主名と副名。nameZhCN には常に簡体字の元の名前が入ります

categoryName, description, tagsその言語のカテゴリ名、説明、タグ。タグは機械翻訳しません

urls.pageその言語の詳細ページのパス（例：/ja/logo/{slug}）

alternatesすべての言語版の詳細ページの完全な URL。キーは言語コード

対応していない lang を指定すると 400 を返し、本文は { "error": "invalid_locale", "supported": [...] } です。

アセット URL

各ロゴの JSON には urls フィールドがあり、次のアドレスをそのまま使えます。

pagehttps://logohub.afengblog.com/logo/{slug}　詳細ページ（lang 指定時はその言語のアドレス）

svghttps://logohub.afengblog.com/logos/{svgFile}　オリジナルの SVG ファイル

pnghttps://logohub.afengblog.com/logos/{slug}.png　1024×1024 の透過 PNG

jpghttps://logohub.afengblog.com/logos/{slug}.jpg　1024×1024 の白背景 JPEG

webphttps://logohub.afengblog.com/logos/{slug}.webp　1024×1024 の透過 WebP

ラスター画像は slug ごとにその場で生成し、縦横比を保って 1024×1024 に収めます。PNG と WebP は透過、JPEG は白背景で、Cache-Control: public, max-age=31536000 を付けて返すため長期キャッシュできます。

レート制限

https://logohub.afengblog.com/api/*、https://logohub.afengblog.com/mcp、ラスター画像は送信元 IP ごとに毎秒 20 リクエストまでです。
上限を超えると 429 と Retry-After を返し、X-RateLimit-Limit と X-RateLimit-Remaining ヘッダーを付けます。
HTML ページと静的な SVG ファイルには制限はありません。

例

ピンインで検索

curl "https://logohub.afengblog.com/api/search?q=zhifubao&limit=5&lang=ja"

ブランド詳細（日本語版）

curl "https://logohub.afengblog.com/api/logos/alipay?lang=ja"

カテゴリで絞り込み

curl "https://logohub.afengblog.com/api/logos?category=school&limit=5&lang=ja"

1024px PNG をダウンロード

curl -o alipay.png "https://logohub.afengblog.com/logos/alipay.png"

利用範囲

すべてのブランドロゴと商標の知的財産権は各権利者に帰属します。中華人民共和国著作権法第24条に基づき、個人の学習、学術交流、技術研究、デザインの参考に限って掲載しており、許可のない商用利用は禁止します。権利侵害の削除依頼