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

API de recherche de logos

Recherchez des logos de marques par mot-clé, affinez éventuellement par catégorie, inspectez les assets disponibles et récupérez le fichier dont vous avez besoin dans un seul workflow requête-réponse propre.

Symboles de marqueLogotypesRécupération d'assets
auth · x-api-key

Pas encore de clé API ?

Connectez-vous à votre compte pour créer et gérer vos clés API.

Requête

Saisissez un terme de recherche obligatoire, affinez éventuellement par catégorie, puis envoyez une seule requête.

GET /api/logos
Catégorie
Exemples rapides
Structure de la requête
Le paramètre search est obligatoire.
GET /api/logos?search=openai&limit=24

Réponse

Examinez les correspondances, inspectez l'asset sélectionné, puis copiez-le ou téléchargez-le.

Prêt
Aucune réponse pour l'instant

Lancez une recherche pour charger les logos correspondants et inspecter la réponse.

[ 02 · integrate ]

Guide d'intégration

Copiez un extrait, remplacez votre clé API, exécutez. Fonctionne avec n'importe quel client HTTP — exemples ci-dessous en cURL, JavaScript et 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.

paramètres
searchstringrequis

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

categorystringoptionnel

Restrict search to a specific category. AI

limitnumberoptionnel

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 · réponse
[
  {
    "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 ]

Limites de débit

La limitation est par clé API, fenêtre glissante de 60 secondes. En cas de dépassement, vous recevez un 429 propre avec un en-tête Retry-After.

débit de requêtes

120req/min

Par clé API, par endpoint. Fenêtre glissante de 60 secondes.

concurrence

3concurrent

Nombre maximal de requêtes simultanées en cours par clé API.

en-têtes de réponse
X-RateLimit-LimitNombre maximal de requêtes autorisées par minute
X-RateLimit-RemainingRequêtes restantes dans la fenêtre actuelle
X-RateLimit-ResetSecondes avant la réinitialisation de la fenêtre actuelle
Retry-AfterSecondes à attendre avant de réessayer (uniquement sur 429)
● 429 · trop de requêtes
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
}

Questions fréquentes

Q : Que renvoie l'endpoint de recherche ?

A: Il renvoie un tableau compact d'enregistrements de logos avec les champs essentiels : id, title, categories, url et assets, ainsi que des métadonnées d'asset telles que le ratio d'aspect et les cas d'usage suggérés.

Q : Puis-je lister le catalogue complet de logos sans terme de recherche ?

A: Non. GET /api/logos requiert un paramètre search non vide. Cet endpoint est conçu pour une recherche ciblée plutôt que pour l'export de toute la bibliothèque.

Q : Comment récupérer un fichier de logo ?

A: Effectuez une recherche avec GET /api/logos, puis utilisez le champ url de chaque asset pour récupérer ou intégrer le fichier directement — aucun appel d'API supplémentaire n'est nécessaire.

Q : Est-ce uniquement pour les logos SVG ?

A: Non. Le SVG est le format principal aujourd'hui, et les formats PNG, WebP et d'autres assets sont en cours d'ajout. La réponse de recherche est déjà structurée autour de métadonnées d'asset génériques afin que les clients puissent prendre en charge proprement plus d'un format de fichier.