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 與其他資源格式也正在陸續加入。搜尋回應已圍繞通用的資源中繼資料來建構,因此用戶端可以乾淨地支援多種檔案格式。