apipick
[ reference · logos ]● 2 cr · 120 req/min

Logo 搜索 API

按关键词搜索品牌 Logo，可选按类别缩小范围，查看可用资源，并在一次干净的请求—响应流程中获取你需要的文件。

品牌标志文字标志资源获取
auth · x-api-key

还没有 API 密钥？

登录账户以创建和管理您的 API 密钥。

登录管理 API 密钥

请求

输入必填的搜索词，可选按类别缩小范围，然后提交一次请求。

GET /api/logos
类别
快速示例
请求结构
参数 search 为必填项。
GET /api/logos?search=openai&limit=24

响应

查看匹配结果，检视所选资源，然后复制或下载。

就绪
暂无响应

提交一次搜索请求，以加载匹配的 Logo 并查看响应。

[ 02 · integrate ]

集成指南

复制代码片段，替换你的 API 密钥，运行即可。适用于任何 HTTP 客户端——下方提供 cURL、JavaScript 和 Python 示例。

spec
GET/api/logos?search=vercel&limit=12
base
https://www.apipick.com

Search logo metadata by required keyword and optional category filter. The response is an array of matching logo records with asset details.

参数
searchstring必填

Required keyword for case-insensitive title/slug matching. openai

categorystring可选

Restrict search to a specific category. AI

limitnumber可选

Maximum results to return. 1-100. 24

curl -X GET "https://www.apipick.com/api/logos?search=vercel&limit=12" \
  -H "x-api-key: YOUR_API_KEY"
● 200 · 响应
[
  {
    "id": 371,
    "title": "Vercel",
    "categories": [
      "Vercel"
    ],
    "url": "https://vercel.com",
    "assets": [
      {
        "kind": "logo",
        "theme": "light",
        "filename": "vercel.svg",
        "url": "https://www.apipick.com/logo-library/vercel.svg",
        "width": 76,
        "height": 65,
        "aspectRatio": "76:65",
        "suggestedUseCases": [
          "app icons",
          "favicons",
          "avatars",
          "navigation bars",
          "mobile headers"
        ]
      },
      {
        "kind": "logo",
        "theme": "dark",
        "filename": "vercel_dark.svg",
        "url": "https://www.apipick.com/logo-library/vercel_dark.svg",
        "width": 76,
        "height": 65,
        "aspectRatio": "76:65",
        "suggestedUseCases": [
          "app icons",
          "favicons",
          "avatars",
          "navigation bars",
          "mobile headers"
        ]
      }
    ]
  }
]
[ 03 · limits ]

速率限制

限流按 API 密钥计，采用 60 秒滑动窗口。触发限制时会返回干净的 429，并带 Retry-After 响应头。

请求速率

120req/min

按 API 密钥、按端点计。60 秒滑动窗口。

并发

3concurrent

每个 API 密钥的最大同时进行中请求数。

响应头
X-RateLimit-Limit每分钟允许的最大请求数
X-RateLimit-Remaining当前窗口内剩余的请求数
X-RateLimit-Reset当前窗口重置前的秒数
Retry-After重试前需等待的秒数（仅在 429 时）
● 429 · 请求过多
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

常见问题

问： 搜索端点返回什么？

A: 它返回一个紧凑的 Logo 记录数组，包含核心字段：id、title、categories、url 和 assets，以及诸如宽高比和建议使用场景等资源元数据。

问： 我能不带搜索词列出完整的 Logo 目录吗？

A: 不能。GET /api/logos 要求传入非空的 search 参数。该端点专为定向查找而设计，而非全库导出。

问： 我如何获取一个 Logo 文件？

A: 用 GET /api/logos 搜索，然后使用每个资源中的 url 字段直接获取或嵌入该文件——无需额外的 API 调用。

问： 这只适用于 SVG Logo 吗？

A: 不是。SVG 是目前的主要格式，PNG、WebP 和更多资源格式正在陆续加入。搜索响应已围绕通用的资源元数据进行结构化，因此客户端可以干净利落地支持不止一种文件格式。