What does the search endpoint return?

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.

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

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

How do I retrieve a logo file?

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.

Is this only for SVG logos?

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.

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

Búsqueda de Logos API

Busca logos de marca por palabra clave, acota opcionalmente por categoría, inspecciona los recursos disponibles y obtén el archivo que necesitas en un flujo limpio de solicitud y respuesta.

Marcas gráficasLogotipos de textoObtención de recursos

auth · x-api-key

Clave API

¿No tienes una clave API?

Inicia sesión en tu cuenta para crear y gestionar tus claves API.

Iniciar sesión Gestionar claves API

Solicitud

Introduce un término de búsqueda obligatorio, acota opcionalmente por categoría y luego envía una solicitud.

GET /api/logos

Respuesta

Revisa las coincidencias, inspecciona el recurso seleccionado y luego cópialo o descárgalo.

Listo

Aún no hay respuesta

Envía una solicitud de búsqueda para cargar los logos coincidentes e inspeccionar la respuesta.

[ 02 · integrate ]

Guía de integración

Copia un fragmento, sustituye tu clave de API y ejecútalo. Funciona en cualquier cliente HTTP — ejemplos abajo en cURL, JavaScript y 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.

parámetros

searchstringobligatorio

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

categorystringopcional

Restrict search to a specific category. AI

limitnumberopcional

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 · respuesta

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

Límites de tasa

La limitación es por clave de API, ventana deslizante de 60 segundos. Al alcanzar el límite recibes un 429 limpio con una cabecera Retry-After.

tasa de peticiones

120req/min

Por clave de API, por endpoint. Ventana deslizante de 60 segundos.

concurrencia

3concurrent

Máximo de peticiones simultáneas en curso por clave de API.

cabeceras de respuesta

X-RateLimit-LimitMáximo de peticiones permitidas por minuto

X-RateLimit-RemainingPeticiones restantes en la ventana actual

X-RateLimit-ResetSegundos hasta que se reinicia la ventana actual

Retry-AfterSegundos a esperar antes de reintentar (solo en 429)

● 429 · demasiadas peticiones

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
}

Preguntas frecuentes

P: ¿Qué devuelve el endpoint de búsqueda?

A: Devuelve un array compacto de registros de logos con los campos principales: id, title, categories, url y assets, además de metadatos del recurso como la proporción de aspecto y los casos de uso sugeridos.

P: ¿Puedo listar el catálogo completo de logos sin un término de búsqueda?

A: No. GET /api/logos requiere un parámetro search no vacío. Este endpoint está diseñado para búsquedas concretas, no para exportar la biblioteca completa.

P: ¿Cómo obtengo el archivo de un logo?

A: Busca con GET /api/logos y luego usa el campo url de cada recurso para obtener o incrustar el archivo directamente, sin necesidad de una llamada adicional a la API.

P: ¿Es solo para logos SVG?

A: No. SVG es el formato principal a día de hoy, y se están añadiendo PNG, WebP y otros formatos de recurso. La respuesta de búsqueda ya está estructurada en torno a metadatos genéricos de recurso para que los clientes puedan admitir varios formatos de archivo de forma limpia.