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

Logo Arama API

Marka logolarını anahtar kelimeye göre arayın, isterseniz kategoriye göre daraltın, mevcut varlıkları inceleyin ve ihtiyacınız olan dosyayı tek bir temiz istek-yanıt akışında alın.

Marka işaretleriKelime işaretleriVarlık alma
auth · x-api-key

API key'iniz yok mu?

API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.

İstek

Zorunlu bir arama terimi girin, isterseniz kategoriye göre daraltın, ardından tek bir istek gönderin.

GET /api/logos
Kategori
Hızlı örnekler
İstek yapısı
Bu search parametresi zorunludur.
GET /api/logos?search=openai&limit=24

Yanıt

Eşleşmeleri gözden geçirin, seçili varlığı inceleyin, ardından kopyalayın veya indirin.

Hazır
Henüz yanıt yok

Eşleşen logoları yüklemek ve yanıtı incelemek için bir arama isteği gönderin.

[ 02 · integrate ]

Entegrasyon rehberi

Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.

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.

parametreler
searchstringzorunlu

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

categorystringisteğe bağlı

Restrict search to a specific category. AI

limitnumberisteğe bağlı

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 · yanıt
[
  {
    "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'ler

Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.

istek hızı

120req/min

API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.

eşzamanlılık

3concurrent

API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.

yanıt başlıkları
X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısı
X-RateLimit-RemainingMevcut penceredeki kalan istek sayısı
X-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniye
Retry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)
● 429 · çok fazla istek
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
}

Sıkça Sorulan Sorular

S: Arama endpoint'i ne döndürür?

A: Temel alanlarla birlikte kompakt bir logo kayıtları dizisi döndürür: id, title, categories, url ve assets; ayrıca en boy oranı ve önerilen kullanım senaryoları gibi varlık meta verileri.

S: Bir arama terimi olmadan tüm logo kataloğunu listeleyebilir miyim?

A: Hayır. GET /api/logos, boş olmayan bir search parametresi gerektirir. Bu endpoint, tüm kütüphaneyi dışa aktarmaktan çok hedefli sorgulama için tasarlanmıştır.

S: Bir logo dosyasını nasıl alırım?

A: GET /api/logos ile arama yapın, ardından her varlıktaki url alanını kullanarak dosyayı doğrudan alın veya gömün — ek bir API çağrısına gerek yok.

S: Bu yalnızca SVG logolar için mi?

A: Hayır. Bugün birincil biçim SVG'dir; PNG, WebP ve ek varlık biçimleri de ekleniyor. Arama yanıtı zaten genel varlık meta verileri etrafında yapılandırılmıştır, böylece istemciler birden fazla dosya biçimini temiz bir şekilde destekleyebilir.