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

Logo Search API

Search brand logos by keyword, optionally narrow by category, inspect available assets, and retrieve the file you need in one clean request-and-response workflow.

Brand marksWordmarksAsset retrieval
auth · x-api-key

Pas encore de clé API ?

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

Request

Enter a required search term, optionally narrow by category, then submit one request.

GET /api/logos
Category
Quick examples
Request shape
The search parameter is required.
GET /api/logos?search=openai&limit=24

Response

Review matches, inspect the selected asset, then copy or download it.

Ready
No response yet

Submit a search request to load matching logos and inspect the response.

[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and 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
searchstringrequired

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

categorystringoptional

Restrict search to a specific category. AI

limitnumberoptional

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 · response
[
  {
    "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, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

120req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetSeconds until the current window resets
Retry-AfterSeconds to wait before retrying (only on 429)
● 429 · too many requests
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
}

Frequently Asked Questions

Q: What does the search endpoint return?

A: It returns a compact array of logo records with the core fields: id, title, categories, url, and assets, plus asset metadata such as aspect ratio and suggested use cases.

Q: Can I list the full logo catalog without a search term?

A: No. GET /api/logos requires a non-empty search parameter. This endpoint is designed for targeted lookup rather than full-library export.

Q: How do I retrieve a logo file?

A: Search with GET /api/logos, then use the url field in each asset to fetch or embed the file directly — no additional API call needed.

Q: Is this only for SVG logos?

A: No. SVG is the primary format today, and PNG, WebP, and additional asset formats are being added. The search response is already structured around generic asset metadata so clients can support more than one file format cleanly.