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

ロゴ 検索 API

キーワードでブランドロゴを検索し、必要に応じてカテゴリで絞り込み、利用可能なアセットを確認して、クリーンな1回のリクエスト&レスポンスのワークフローで必要なファイルを取得できます。

ブランドマークワードマークアセット取得
auth · x-api-key

APIキーをお持ちでない方は

アカウントにサインインしてAPIキーを作成・管理してください。

サインインAPIキーを管理

リクエスト

必須の検索語を入力し、必要に応じてカテゴリで絞り込み、リクエストを1回送信します。

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秒のスライディングウィンドウです。上限に達すると、Retry-Afterヘッダー付きのクリーンな429が返されます。

リクエストレート

120req/min

APIキー単位・エンドポイント単位。60秒のスライディングウィンドウ。

同時実行数

3concurrent

APIキーごとの同時進行リクエストの最大数。

レスポンスヘッダー
X-RateLimit-Limit1分あたりに許可される最大リクエスト数
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
}

よくある質問

Q: 検索エンドポイントは何を返しますか？

A: id、title、categories、url、assets というコアフィールドに加え、アスペクト比や推奨ユースケースといったアセットのメタデータを含む、コンパクトなロゴレコードの配列を返します。

Q: 検索語なしでロゴカタログ全体を一覧できますか？

A: いいえ。GET /api/logos は空でない search パラメータを必須とします。このエンドポイントはライブラリ全体のエクスポートではなく、ターゲットを絞った検索向けに設計されています。

Q: ロゴファイルはどのように取得しますか？

A: GET /api/logos で検索し、各アセットの url フィールドを使ってファイルを直接取得または埋め込みます — 追加のAPIコールは不要です。

Q: これはSVGロゴ専用ですか？

A: いいえ。現時点ではSVGが主要なフォーマットですが、PNG、WebP、その他のアセットフォーマットを追加中です。検索レスポンスは既に汎用的なアセットメタデータを軸に構造化されているため、クライアントは複数のファイルフォーマットをクリーンにサポートできます。