Open Interface

Open HTTP API

Brand metadata, inline SVG source code, and 1024px raster exports are publicly accessible via read-only JSON endpoints. No registration or API key required.

Endpoint SpecificationHTTPS · GET

https://logohub.afengblog.com/api

Returns application/json; charset=utf-8, rate-limited to 20 requests/sec per IP

Endpoints

GET https://logohub.afengblog.com/api/search?q=&category=&sort=&order=&limit=&offset=&lang=Keyword search across English names, Chinese names (Simplified & Traditional), and Pinyin; q is required, up to 20 items per request, sort accepts latest / name, order accepts asc / desc (defaults: newest first, A–Z)

GET https://logohub.afengblog.com/api/logos/:slug?lang=Single brand metadata including inline SVG source code, color palette, asset URLs, and related logos

GET https://logohub.afengblog.com/api/logos?q=&category=&sort=&order=&limit=&offset=&lang=Paginated list & category filter (SVG source omitted by default); limit max 20

GET https://logohub.afengblog.com/api/statsTotal indexed logos, per-category counts, and last seed timestamp

GET https://logohub.afengblog.com/api/healthService and SQLite database readiness probe (returns 503 if not ready)

Languages

Search, list, and detail endpoints accept an optional lang parameter: zh-CN / zh-TW / ja / en (case-insensitive, defaults to zh-CN).

localePresent on the response and on every item, identifying the language version of the returned content

name, enNamePrimary and secondary brand names for that language; nameZhCN always keeps the original Simplified Chinese name

categoryName, description, tagsLocalized category, description, and tags; tags are not machine-translated

urls.pageDetail page path for that language, e.g. /ja/logo/{slug}

alternatesAbsolute detail page URLs for every language version, keyed by language code

An unsupported lang value returns HTTP 400 with { "error": "invalid_locale", "supported": [...] }.

Asset URLs

Every logo JSON object includes a urls field with ready-to-use paths for vector and raster formats.

pagehttps://logohub.afengblog.com/logo/{slug} — Brand detail page (localized when lang is set)

svghttps://logohub.afengblog.com/logos/{svgFile} — Original lossless SVG file

pnghttps://logohub.afengblog.com/logos/{slug}.png — 1024×1024 transparent PNG

jpghttps://logohub.afengblog.com/logos/{slug}.jpg — 1024×1024 white-background JPEG

webphttps://logohub.afengblog.com/logos/{slug}.webp — 1024×1024 transparent WebP

Raster images are rendered on-demand at 1024×1024 with Cache-Control: public, max-age=31536000 for long-term CDN caching.

Rate Limiting

https://logohub.afengblog.com/api/*, https://logohub.afengblog.com/mcp, and raster image routes are limited to 20 requests/sec per client IP.
Exceeding the limit returns HTTP 429 with Retry-After, X-RateLimit-Limit, and X-RateLimit-Remaining headers.
HTML pages and static SVG vector files are never rate-limited.

Examples

Keyword search

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

Single brand detail (Japanese)

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

Category filter

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

Download 1024px PNG

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

All brand logos and trademarks belong to their respective owners. Indexed on LogoHub pursuant to Article 24 of the Copyright Law of the People's Republic of China strictly for non-commercial personal study, academic research, technical evaluation, and design reference. DMCA Takedown Request