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

Logo Search API

Zoek merklogo's op trefwoord, beperk eventueel op categorie, bekijk beschikbare assets en haal het gewenste bestand op in één schone request-en-response-workflow.

BeeldmerkenWordmarksAssets ophalen
auth · x-api-key

Heb je geen API key?

Meld je aan bij je account om je API keys aan te maken en te beheren.

Verzoek

Voer een verplichte zoekterm in, beperk eventueel op categorie en verstuur één verzoek.

GET /api/logos
Categorie
Snelle voorbeelden
Vorm van het verzoek
De parameter search is verplicht.
GET /api/logos?search=openai&limit=24

Reactie

Bekijk matches, inspecteer de geselecteerde asset en kopieer of download hem.

Klaar
Nog geen reactie

Verstuur een zoekopdracht om overeenkomende logo's te laden en de reactie te inspecteren.

[ 02 · integrate ]

Integratiegids

Kopieer een snippet, vervang je API key, draaien. Werkt in elke HTTP-client — voorbeelden hieronder in cURL, JavaScript en 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.

parameters
searchstringverplicht

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

categorystringoptioneel

Restrict search to a specific category. AI

limitnumberoptioneel

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 · reactie
[
  {
    "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 limits

Throttling is per API key, een verschuivend venster van 60 seconden. Bereik je de limiet, dan krijg je een nette 429 met een Retry-After-header.

verzoeksnelheid

120req/min

Per API key, per endpoint. Verschuivend venster van 60 seconden.

gelijktijdigheid

3concurrent

Max. gelijktijdig lopende verzoeken per API key.

response headers
X-RateLimit-LimitMaximaal toegestane verzoeken per minuut
X-RateLimit-RemainingResterende verzoeken in het huidige venster
X-RateLimit-ResetSeconden tot het huidige venster opnieuw start
Retry-AfterSeconden te wachten voor opnieuw proberen (alleen bij 429)
● 429 · te veel verzoeken
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
}

Veelgestelde vragen

V: Wat geeft het zoek-endpoint terug?

A: Het geeft een compacte array van logorecords terug met de kernvelden: id, title, categories, url en assets, plus assetmetadata zoals beeldverhouding en voorgestelde use cases.

V: Kan ik de volledige logocatalogus opvragen zonder zoekterm?

A: Nee. GET /api/logos vereist een niet-lege search-parameter. Dit endpoint is ontworpen voor gerichte opzoeking, niet voor export van de volledige bibliotheek.

V: Hoe haal ik een logobestand op?

A: Zoek met GET /api/logos en gebruik vervolgens het url-veld in elke asset om het bestand direct op te halen of in te bedden — geen extra API-aanroep nodig.

V: Is dit alleen voor SVG-logo's?

A: Nee. SVG is momenteel het primaire formaat, en PNG, WebP en aanvullende assetformaten worden toegevoegd. De zoekreactie is al gestructureerd rond generieke assetmetadata, zodat clients meer dan één bestandsformaat netjes kunnen ondersteunen.