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

Поиск логотипов API

Ищите логотипы брендов по ключевому слову, при желании сужайте по категории, изучайте доступные ресурсы и получайте нужный файл за один чистый цикл запроса и ответа.

Фирменные знакиТекстовые логотипыПолучение ресурсов
auth · x-api-key

Нет API-ключа?

Войдите в аккаунт, чтобы создавать и управлять API-ключами.

Запрос

Введите обязательный поисковый запрос, при желании сузьте по категории и отправьте один запрос.

GET /api/logos
Категория
Быстрые примеры
Структура запроса
Параметр search обязателен.
GET /api/logos?search=openai&limit=24

Ответ

Просмотрите совпадения, изучите выбранный ресурс, затем скопируйте или скачайте его.

Готово
Пока нет ответа

Отправьте поисковый запрос, чтобы загрузить подходящие логотипы и изучить ответ.

[ 02 · integrate ]

Руководство по интеграции

Скопируйте сниппет, подставьте свой API-ключ, запустите. Работает в любом HTTP-клиенте — примеры ниже на cURL, JavaScript и 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.

параметры
searchstringобязательный

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

categorystringнеобязательный

Restrict search to a specific category. AI

limitnumberнеобязательный

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 · ответ
[
  {
    "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 ]

Лимиты запросов

Ограничение действует на API-ключ, скользящее окно 60 секунд. При превышении вы получаете чистый 429 с заголовком Retry-After.

частота запросов

120req/min

На API-ключ, на эндпоинт. Скользящее окно 60 секунд.

параллелизм

3concurrent

Максимум одновременных активных запросов на API-ключ.

заголовки ответа
X-RateLimit-LimitМаксимум запросов в минуту
X-RateLimit-RemainingОсталось запросов в текущем окне
X-RateLimit-ResetСекунд до сброса текущего окна
Retry-AfterСколько секунд ждать перед повтором (только при 429)
● 429 · слишком много запросов
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
}

Часто задаваемые вопросы

В: Что возвращает эндпоинт поиска?

A: Он возвращает компактный массив записей логотипов с основными полями: id, title, categories, url и assets, а также метаданные ресурсов, такие как соотношение сторон и рекомендуемые сценарии использования.

В: Можно ли получить полный каталог логотипов без поискового запроса?

A: Нет. GET /api/logos требует непустого параметра поиска. Этот эндпоинт предназначен для целевого поиска, а не для выгрузки всей библиотеки.

В: Как получить файл логотипа?

A: Выполните поиск через GET /api/logos, затем используйте поле url каждого ресурса, чтобы получить или встроить файл напрямую — дополнительный вызов API не нужен.

В: Это только для SVG-логотипов?

A: Нет. Сегодня SVG — основной формат, но добавляются PNG, WebP и другие форматы ресурсов. Ответ поиска уже построен вокруг универсальных метаданных ресурсов, чтобы клиенты могли корректно поддерживать более одного формата файлов.