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

Wyszukiwanie logo API

Wyszukuj logo marek według słowa kluczowego, opcjonalnie zawężaj według kategorii, sprawdzaj dostępne zasoby i pobieraj potrzebny plik w jednym przejrzystym przepływie żądanie-odpowiedź.

Znaki markiLogotypy tekstowePobieranie zasobów
auth · x-api-key

Nie masz klucza API?

Zaloguj się na swoje konto, aby tworzyć klucze API i nimi zarządzać.

Żądanie

Wpisz wymagany termin wyszukiwania, opcjonalnie zawęź według kategorii, a następnie wyślij jedno żądanie.

GET /api/logos
Kategoria
Szybkie przykłady
Format żądania
Parametr search jest wymagany.
GET /api/logos?search=openai&limit=24

Odpowiedź

Przejrzyj dopasowania, sprawdź wybrany zasób, a następnie skopiuj go lub pobierz.

Gotowe
Brak odpowiedzi

Wyślij żądanie wyszukiwania, aby załadować pasujące logo i sprawdzić odpowiedź.

[ 02 · integrate ]

Przewodnik integracji

Skopiuj fragment kodu, podmień swój klucz API, uruchom. Działa w dowolnym kliencie HTTP — przykłady poniżej w cURL, JavaScript i Pythonie.

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.

parametry
searchstringwymagane

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

categorystringopcjonalne

Restrict search to a specific category. AI

limitnumberopcjonalne

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

Limity zapytań

Ograniczanie działa per klucz API, w przesuwnym oknie 60 sekund. Po przekroczeniu limitu otrzymasz czyste 429 z nagłówkiem Retry-After.

częstotliwość żądań

120req/min

Per klucz API, per endpoint. Przesuwne okno 60 sekund.

współbieżność

3concurrent

Maksymalna liczba jednoczesnych żądań w toku na klucz API.

nagłówki odpowiedzi
X-RateLimit-LimitMaksymalna dozwolona liczba żądań na minutę
X-RateLimit-RemainingPozostała liczba żądań w bieżącym oknie
X-RateLimit-ResetSekundy do zresetowania bieżącego okna
Retry-AfterSekundy oczekiwania przed ponowieniem (tylko przy 429)
● 429 · zbyt wiele żądań
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
}

Najczęściej zadawane pytania

P: Co zwraca endpoint wyszukiwania?

A: Zwraca kompaktową tablicę rekordów logo z podstawowymi polami: id, title, categories, url oraz assets, wraz z metadanymi zasobów, takimi jak proporcje i sugerowane przypadki użycia.

P: Czy mogę wyświetlić pełny katalog logo bez terminu wyszukiwania?

A: Nie. GET /api/logos wymaga niepustego parametru search. Ten endpoint jest przeznaczony do ukierunkowanego wyszukiwania, a nie eksportu całej biblioteki.

P: Jak pobrać plik logo?

A: Wyszukaj za pomocą GET /api/logos, a następnie użyj pola url w każdym zasobie, aby pobrać lub osadzić plik bezpośrednio — bez dodatkowego wywołania API.

P: Czy to tylko logo w formacie SVG?

A: Nie. SVG jest dziś głównym formatem, a PNG, WebP i dodatkowe formaty zasobów są w trakcie dodawania. Odpowiedź wyszukiwania jest już zbudowana wokół ogólnych metadanych zasobów, dzięki czemu klienci mogą czysto obsługiwać więcej niż jeden format pliku.