跳到主要内容
LogoHub
开放接口

开放 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 必填，单次最多返回 20 条，sort 取 latest / name，order 取 asc / desc（缺省时最近更新为新→旧、名称为 A→Z）
GET https://logohub.afengblog.com/api/logos/:slug?lang=单个品牌元数据，包含内联 SVG 源码、资源 URL 与同类推荐
GET https://logohub.afengblog.com/api/logos?q=&category=&sort=&order=&limit=&offset=&lang=列表与筛选，默认不含 SVG 源码；limit 上限 20，sort 与 order 取值同检索接口
GET https://logohub.afengblog.com/api/stats收录总量、各分类计数与最近入库时间
GET https://logohub.afengblog.com/api/health服务与数据库健康状态，数据库未就绪时返回 503

多语言

检索、列表与详情接口接受可选参数 lang，取值 zh-CN / zh-TW / ja / en，大小写不敏感，缺省为 zh-CN。

locale响应顶层与每条结果都带 locale，标明本次返回内容的语言版本
name, enName该语言的品牌主名与副名；nameZhCN 始终保留简体原名，便于跨语言对齐
categoryName, description, tags该语言的分类名、描述与标签；标签不做翻译，繁体只转换字形
urls.page该语言的详情页地址，例如 /ja/logo/{slug}
alternates全部语言版本详情页的完整地址，键为语言代码

lang 取值不在列表内时返回 400，响应体为 { "error": "invalid_locale", "supported": [...] }。

资源 URL

每条 logo JSON 附带 urls 字段，直接在响应内给出下列地址，无需自行拼接路径。

pagehttps://logohub.afengblog.com/logo/{slug}　品牌详情页（带 lang 时为对应语言的地址）
svghttps://logohub.afengblog.com/logos/{svgFile}　原始矢量文件，静态直出
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 页面与静态矢量文件不限流。

示例

拼音检索
curl "https://logohub.afengblog.com/api/search?q=zhifubao&limit=5"
单品牌详情（日语版本）
curl "https://logohub.afengblog.com/api/logos/alipay?lang=ja"
分类列表
curl "https://logohub.afengblog.com/api/logos?category=school&limit=5"
下载 1024px PNG
curl -o alipay.png "https://logohub.afengblog.com/logos/alipay.png"
使用范围

全部品牌标志与商标的知识产权归原权利人所有。内容依据《中华人民共和国著作权法》第二十四条仅供个人学习、学术交流、技术研发与设计鉴赏，禁止未经授权的商业使用。 侵权下架申请

操作已完成