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

Pencarian Logo API

Cari logo merek berdasarkan kata kunci, persempit lewat kategori jika perlu, periksa aset yang tersedia, dan ambil file yang kamu butuhkan dalam satu alur request-and-response yang rapi.

Brand markWordmarkPengambilan aset
auth · x-api-key

Belum punya API key?

Masuk ke akun Anda untuk membuat dan mengelola API key.

Request

Masukkan istilah pencarian yang wajib, persempit lewat kategori jika perlu, lalu kirim satu request.

GET /api/logos
Kategori
Contoh cepat
Bentuk request
Parameter search bersifat wajib.
GET /api/logos?search=openai&limit=24

Respons

Tinjau kecocokan, periksa aset yang dipilih, lalu salin atau unduh.

Siap
Belum ada respons

Kirim request pencarian untuk memuat logo yang cocok dan memeriksa responsnya.

[ 02 · integrate ]

Panduan integrasi

Salin snippet, ganti API key kamu, jalankan. Bekerja di HTTP client mana pun — contoh di bawah dalam cURL, JavaScript, dan 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.

parameter
searchstringwajib

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

categorystringopsional

Restrict search to a specific category. AI

limitnumberopsional

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 · respons
[
  {
    "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 ]

Rate limit

Throttling berlaku per API key, jendela geser 60 detik. Jika melewati batas, kamu mendapat 429 yang rapi dengan header Retry-After.

laju request

120req/min

Per API key, per endpoint. Jendela geser 60 detik.

konkurensi

3concurrent

Maksimum request bersamaan yang sedang berjalan per API key.

header respons
X-RateLimit-LimitJumlah maksimum request yang diizinkan per menit
X-RateLimit-RemainingRequest yang tersisa di jendela saat ini
X-RateLimit-ResetDetik sampai jendela saat ini di-reset
Retry-AfterDetik yang harus ditunggu sebelum mencoba lagi (hanya pada 429)
● 429 · terlalu banyak 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
}

Pertanyaan yang Sering Diajukan

T: Apa yang dikembalikan endpoint pencarian?

A: Endpoint mengembalikan array ringkas berisi rekaman logo dengan field inti: id, title, categories, url, dan assets, plus metadata aset seperti rasio aspek dan saran use case.

T: Bisakah saya mendaftar seluruh katalog logo tanpa istilah pencarian?

A: Tidak. GET /api/logos membutuhkan parameter search yang tidak kosong. Endpoint ini dirancang untuk pencarian tertarget, bukan ekspor seluruh pustaka.

T: Bagaimana cara mengambil file logo?

A: Cari dengan GET /api/logos, lalu gunakan field url di setiap aset untuk mengambil atau menyematkan file secara langsung — tanpa panggilan API tambahan.

T: Apakah ini hanya untuk logo SVG?

A: Tidak. SVG adalah format utama saat ini, dan PNG, WebP, serta format aset tambahan sedang ditambahkan. Respons pencarian sudah terstruktur di sekitar metadata aset generik sehingga klien dapat mendukung lebih dari satu format file secara rapi.