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

Ricerca loghi API

Cerca i loghi dei brand per parola chiave, restringi facoltativamente per categoria, ispeziona gli asset disponibili e recupera il file che ti serve in un unico flusso pulito di richiesta e risposta.

Marchi dei brandWordmarkRecupero asset
auth · x-api-key

Non hai una API key?

Accedi al tuo account per creare e gestire le tue API key.

AccediGestisci API key

Richiesta

Inserisci un termine di ricerca obbligatorio, restringi facoltativamente per categoria, quindi invia una richiesta.

GET /api/logos
Categoria
Esempi rapidi
Forma della richiesta
Il parametro search è obbligatorio.
GET /api/logos?search=openai&limit=24

Risposta

Esamina le corrispondenze, ispeziona l'asset selezionato, quindi copialo o scaricalo.

Pronto
Nessuna risposta

Invia una richiesta di ricerca per caricare i loghi corrispondenti e ispezionare la risposta.

[ 02 · integrate ]

Guida all'integrazione

Copia uno snippet, sostituisci la tua API key, esegui. Funziona con qualsiasi client HTTP — esempi qui sotto in cURL, JavaScript e 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.

parametri
searchstringobbligatorio

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

categorystringfacoltativo

Restrict search to a specific category. AI

limitnumberfacoltativo

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

Limiti di frequenza

Il throttling è per API key, con finestra mobile di 60 secondi. Al raggiungimento del limite ricevi un 429 pulito con header Retry-After.

frequenza richieste

120req/min

Per API key e per endpoint. Finestra mobile di 60 secondi.

concorrenza

3concurrent

Numero massimo di richieste simultanee in corso per API key.

header di risposta
X-RateLimit-LimitNumero massimo di richieste consentite al minuto
X-RateLimit-RemainingRichieste rimanenti nella finestra corrente
X-RateLimit-ResetSecondi al reset della finestra corrente
Retry-AfterSecondi da attendere prima di riprovare (solo in caso di 429)
● 429 · troppe richieste
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
}

Domande frequenti

D: Cosa restituisce l'endpoint di ricerca?

A: Restituisce un array compatto di record di logo con i campi principali: id, title, categories, url e assets, più metadati dell'asset come la proporzione e i casi d'uso suggeriti.

D: Posso elencare l'intero catalogo di loghi senza un termine di ricerca?

A: No. GET /api/logos richiede un parametro search non vuoto. Questo endpoint è progettato per la ricerca mirata anziché per l'esportazione dell'intera libreria.

D: Come recupero un file di logo?

A: Cerca con GET /api/logos, quindi usa il campo url in ogni asset per recuperare o incorporare direttamente il file — senza chiamate API aggiuntive.

D: È solo per loghi SVG?

A: No. Oggi SVG è il formato principale, e si stanno aggiungendo PNG, WebP e altri formati di asset. La risposta di ricerca è già strutturata attorno a metadati di asset generici, così i client possono supportare più formati di file in modo pulito.