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

Tìm kiếm Logo API

Tìm logo thương hiệu theo từ khóa, tùy chọn thu hẹp theo danh mục, xem các asset có sẵn và lấy tập tin bạn cần trong một quy trình yêu cầu-và-phản hồi gọn gàng.

Dấu hiệu thương hiệuWordmarkLấy asset
auth · x-api-key

Chưa có API key?

Đăng nhập vào tài khoản để tạo và quản lý API key của bạn.

Yêu cầu

Nhập một từ khóa tìm kiếm bắt buộc, tùy chọn thu hẹp theo danh mục, rồi gửi một yêu cầu.

GET /api/logos
Danh mục
Ví dụ nhanh
Hình dạng yêu cầu
Tham số search là bắt buộc.
GET /api/logos?search=openai&limit=24

Phản hồi

Xem các kết quả khớp, kiểm tra asset đã chọn, rồi sao chép hoặc tải xuống.

Sẵn sàng
Chưa có phản hồi

Gửi một yêu cầu tìm kiếm để tải các logo khớp và xem phản hồi.

[ 02 · integrate ]

Hướng dẫn tích hợp

Sao chép một đoạn mã, thay API key của bạn, chạy. Hoạt động với mọi HTTP client — các ví dụ bên dưới bằng cURL, JavaScript và 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.

tham số
searchstringbắt buộc

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

categorystringtùy chọn

Restrict search to a specific category. AI

limitnumbertùy chọn

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 · phản hồi
[
  {
    "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 ]

Giới hạn tần suất

Giới hạn tốc độ tính theo từng API key, cửa sổ trượt 60 giây. Vượt giới hạn, bạn nhận được phản hồi 429 sạch sẽ kèm header Retry-After.

tốc độ request

120req/min

Theo từng API key, từng endpoint. Cửa sổ trượt 60 giây.

đồng thời

3concurrent

Số request đang chạy tối đa đồng thời cho mỗi API key.

header phản hồi
X-RateLimit-LimitSố request tối đa cho phép mỗi phút
X-RateLimit-RemainingSố request còn lại trong cửa sổ hiện tại
X-RateLimit-ResetSố giây cho đến khi cửa sổ hiện tại được đặt lại
Retry-AfterSố giây cần chờ trước khi thử lại (chỉ khi 429)
● 429 · quá nhiều request
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
}

Câu hỏi thường gặp

Hỏi: Endpoint tìm kiếm trả về gì?

A: Nó trả về một mảng gọn các bản ghi logo với các trường cốt lõi: id, title, categories, url và assets, cùng metadata asset như tỷ lệ khung hình và trường hợp sử dụng gợi ý.

Hỏi: Tôi có thể liệt kê toàn bộ danh mục logo mà không cần từ khóa tìm kiếm không?

A: Không. GET /api/logos cần một tham số search không rỗng. Endpoint này được thiết kế cho tra cứu có mục tiêu chứ không phải xuất toàn bộ thư viện.

Hỏi: Làm sao để lấy một tập tin logo?

A: Tìm bằng GET /api/logos, rồi dùng trường url trong mỗi asset để lấy hoặc nhúng tập tin trực tiếp — không cần lệnh gọi API bổ sung.

Hỏi: Cái này chỉ dành cho logo SVG thôi sao?

A: Không. SVG là định dạng chính hiện nay, và PNG, WebP cùng các định dạng asset khác đang được bổ sung. Phản hồi tìm kiếm đã được cấu trúc quanh metadata asset chung để client có thể hỗ trợ nhiều định dạng tập tin một cách gọn gàng.