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

Busca de Logos API

Busque logos de marcas por palavra-chave, opcionalmente filtre por categoria, inspecione os recursos disponíveis e recupere o arquivo que você precisa em um fluxo limpo de requisição e resposta.

Símbolos de marcaWordmarksRecuperação de recursos
auth · x-api-key

Não tem uma API key?

Faça login na sua conta para criar e gerenciar suas API keys.

Requisição

Insira um termo de busca obrigatório, opcionalmente filtre por categoria e envie uma requisição.

GET /api/logos
Categoria
Exemplos rápidos
Formato da requisição
O parâmetro search é obrigatório.
GET /api/logos?search=openai&limit=24

Resposta

Revise as correspondências, inspecione o recurso selecionado e depois copie ou baixe.

Pronto
Nenhuma resposta ainda

Envie uma requisição de busca para carregar os logos correspondentes e inspecionar a resposta.

[ 02 · integrate ]

Guia de integração

Copie um trecho, troque sua API key e execute. Funciona em qualquer cliente HTTP — exemplos abaixo em 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.

parâmetros
searchstringobrigatório

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

O throttling é por API key, em janela deslizante de 60 segundos. Ao atingir o limite, você recebe um 429 limpo com um header Retry-After.

taxa de requisições

120req/min

Por API key, por endpoint. Janela deslizante de 60 segundos.

concorrência

3concurrent

Máximo de requisições simultâneas em andamento por API key.

headers de resposta
X-RateLimit-LimitMáximo de requisições permitidas por minuto
X-RateLimit-RemainingRequisições restantes na janela atual
X-RateLimit-ResetSegundos até a janela atual reiniciar
Retry-AfterSegundos a aguardar antes de tentar novamente (apenas em 429)
● 429 · requisições em excesso
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
}

Perguntas Frequentes

P: O que o endpoint de busca retorna?

A: Ele retorna um array compacto de registros de logo com os campos principais: id, title, categories, url e assets, além de metadados dos recursos, como proporção de aspecto e casos de uso sugeridos.

P: Posso listar todo o catálogo de logos sem um termo de busca?

A: Não. GET /api/logos exige um parâmetro search não vazio. Este endpoint foi projetado para consulta direcionada, e não para exportar a biblioteca inteira.

P: Como recupero um arquivo de logo?

A: Busque com GET /api/logos e depois use o campo url em cada recurso para obter ou embutir o arquivo diretamente — sem necessidade de chamada de API adicional.

P: É apenas para logos em SVG?

A: Não. O SVG é o formato principal hoje, e PNG, WebP e outros formatos de recurso estão sendo adicionados. A resposta da busca já é estruturada em torno de metadados genéricos de recursos, para que os clientes possam suportar mais de um formato de arquivo de forma limpa.