概要 - Benzinga API Documentation

はじめに

Benzinga Logos API は、企業、ファンド、暗号資産の高品質なロゴ画像へのアクセスを提供しています。シンボル、CIK 番号、ISIN コード、CUSIP、FIGI など、複数種類の識別子を使ってロゴを検索できます。

利用可能なエンドポイント

`/logos/search`

各種識別子でロゴを検索します。ロゴのURL、証券の詳細、およびメタデータを返します。

`/logos/sync`

ページネーション対応の複数ロゴ一括取得用同期エンドポイント。 API は、次の 2 つの主なパラメーターによる柔軟な検索をサポートしています。

search_keys - 検索対象とする識別子の値
search_keys_type - 識別子の種類（オプション。省略時は symbol が使用されます）

1. シンボルでフィルタリング

株式tickerシンボルを使用してロゴを検索します。 パラメータ:

search_keys: シンボル（例: AAPL, TSLA, MSFT）
search_keys_type: symbol（任意、省略時はこれがデフォルト）

例:

GET /api/v2/logos/search?search_keys=AAPL&search_keys_type=symbol&fields=logo_light,logo_dark

2. CIK でフィルターする

SEC の Central Index Key（CIK）を使用して検索します。ゼロ埋めあり／なしの値の両方をサポートします。 パラメータ:

search_keys: CIK 番号（例: 320193 または 0000320193）
search_keys_type: cik

例:

GET /api/v2/logos/search?search_keys=320193&search_keys_type=cik&fields=logo_light,logo_dark

ゼロ埋めCIKの例:

GET /api/v2/logos/search?search_keys=0000320193&search_keys_type=cik&fields=logo_light,logo_dark

3. ISIN でフィルタリング

ISIN（国際証券識別番号）を指定して検索します。 パラメータ:

search_keys: ISIN コード（例: US0378331005）
search_keys_type: isin

例:

GET /api/v2/logos/search?search_keys=US0378331005&search_keys_type=isin&fields=logo_light,logo_dark

Bloomberg の Financial Instrument Global Identifier（FIGI）を使用してシェアクラスを検索します。 パラメータ:

search_keys: FIGIシェアクラスID（例: BBG001SQKGD7）
search_keys_type: figi_share_class

例:

GET /api/v2/logos/search?search_keys=BBG001SQKGD7&search_keys_type=figi_share_class&fields=logo_light,logo_dark

5. CUSIP で絞り込み

Committee on Uniform Securities Identification Procedures（CUSIP）の番号を使って検索します。 パラメータ:

search_keys: CUSIP 番号（例: 88160R101）
search_keys_type: cusip

例:

GET /api/v2/logos/search?search_keys=88160R101&search_keys_type=cusip&fields=logo_light,logo_dark

6. シンボルを通貨・国コードでフィルタリングする

シンボルに国コードまたは通貨コードを、コロン（:）またはピリオド（.）を区切り文字として付けて指定します。 パラメータ:

search_keys: 修飾子付きシンボル（例: AAPL:US, AAPL:USD, AAPL.US）
search_keys_type: symbol

例:

GET /api/v2/logos/search?search_keys=AAPL:US&search_keys_type=symbol&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=AAPL:USD&search_keys_type=symbol&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=AAPL.US&search_keys_type=symbol&fields=logo_light,logo_dark

7. 取引所とシンボルでフィルタリング

取引所コードとシンボルを組み合わせて検索します。Bloomberg 形式（レガシー）と LSEG 形式の両方をサポートします。 Bloomberg 形式のマッピング（レガシー）：

search_keys: 取引所とシンボル（例: NASDAQ:AAPL）
search_keys_type: symbol

LSEG 3文字コード（現行）：

search_keys: 取引所コードとシンボル（例: NSQ:AAPL）
search_keys_type: symbol

例:

GET /api/v2/logos/search?search_keys=NASDAQ:AAPL&search_keys_type=symbol&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=NSQ:AAPL&search_keys_type=symbol&fields=logo_light,logo_dark

8. ISO MIC とシンボルによるフィルタ

ISO Market Identifier Code とシンボルを組み合わせて検索します。 パラメータ:

search_keys: MIC コードとシンボル（例: XYNS:AAPL）
search_keys_type: symbol

例:

GET /api/v2/logos/search?search_keys=XYNS:AAPL&search_keys_type=symbol&fields=logo_light,logo_dark

9. 暗号資産ロゴフィルター

さまざまな形式を使用して暗号資産のロゴを検索します。search_keys_type を指定しなくても、API は暗号資産の形式を自動的に認識します。 サポートされる形式:

CRYPTO:BTC
CRYPTO/BTC
$BTC
BTC/USD

例:

GET /api/v2/logos/search?search_keys=CRYPTO:BTC&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=CRYPTO/BTC&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=$BTC&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=BTC/USD&fields=logo_light,logo_dark

利用可能なフィールド

fields パラメータを使用して、取得するロゴの種類を指定できます。利用可能なフィールドは次のとおりです。

logo_light - ライトテーマのロゴ (PNG)
logo_dark - ダークテーマのロゴ (PNG)
logo_vector_light - ライトテーマのベクター形式ロゴ (SVG)
logo_vector_dark - ダークテーマのベクター形式ロゴ (SVG)
mark_light - ライトテーマのマーク/アイコン (PNG)
mark_dark - ダークテーマのマーク/アイコン (PNG)
mark_vector_light - ライトテーマのベクター形式マーク (SVG)
mark_vector_dark - ダークテーマのベクター形式マーク (SVG)
mark_composite_light - ライトテーマの複合マーク (PNG)
mark_composite_dark - ダークテーマの複合マーク (PNG)
mark_vector_composite_light - ライトテーマのベクター形式複合マーク (SVG)
mark_vector_composite_dark - ダークテーマのベクター形式複合マーク (SVG)

複数フィールドを指定する例:

GET /api/v2/logos/search?search_keys=TSLA&fields=logo_light,logo_dark,mark_vector_composite_light

追加パラメータ

画像カスタマイズ

scale - 画像サイズ（例: 100x100、300x300）
max_width - 返される画像の最大幅
composite_radius - 合成画像のボーダーの角丸半径（整数、範囲 0-50）
composite_auto - 合成画像を自動生成するかどうかを指定（真偽値）

ページネーション（バルク同期時のみ）

page - ページ番号（整数）
pagesize - 1ページあたりの結果数（整数）
updated_since - 更新タイムスタンプによるフィルタ（ISO 8601 形式）

証券の詳細

securities - レスポンスに詳細な証券情報を含める（ブール値）

レスポンス例

200 成功時のレスポンス

{
  "ok": true,
  "data": [
    {
      "id": "efc3943a-ddac-4f59-a2cc-47a67583068b",
      "search_key": "TSLA",
      "securities": [
        {
          "symbol": "TSLA",
          "name": "TESLA INC",
          "cik": "1318605",
          "exchange": "NASDAQ",
          "mic_code": "XNAS",
          "exchange_name": "NASDAQ Global Select Consolidated",
          "cusip": "88160R101",
          "isin": "US88160R1014",
          "country": "US",
          "figi_share_class": "BBG001SQKGD7",
          "figi": "BBG000N9MNX3",
          "security_type": "Common Stock"
        }
      ],
      "files": {
        "logo_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_dark__53646042d4c8b507c7eddb70110ee334.png?x-bz-cred=...",
        "logo_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_light__6895726d0ff148e46c238f91d033e72a.png?x-bz-cred=..."
      },
      "created_at": "2022-05-18T05:19:45.008547Z",
      "updated_at": "2025-02-05T09:43:14.303261Z"
    }
  ]
}

401 Unauthorized レスポンス

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

404 Not Found レスポンス

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "指定された検索キーのロゴが見つかりませんでした"
    }
  ]
}

500 Internal Server Error のレスポンス

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "リクエストの処理中に予期しないエラーが発生しました"
    }
  ]
}

認証

Logos API の全エンドポイントでは、API キーによる認証が必要です。トークンをクエリパラメータとして指定してください。

?token=YOUR_API_KEY

ベストプラクティス

search_keys_type を指定する - API のデフォルトは symbol ですが、種類を明示的に指定することで可読性とパフォーマンスが向上します
必要なフィールドのみをリクエストする - 必要なロゴタイプだけをリクエストして、レスポンスサイズを最小化し、パフォーマンスを向上させます
大規模データセットには bulk-sync を使用する - 複数のロゴを取得する場合は、ページネーション付きの /logos/bulk-sync エンドポイントを使用します
レスポンスをキャッシュする - ロゴの URL には有効期限のタイムスタンプが含まれているため、適切にキャッシュして API コールを削減します
エラーを適切に処理する - レスポンス内の ok フィールドを常に確認し、エラーケースを適切に処理してください

レート制限

レート制限の詳細については、ご契約の API サブスクリプションプランをご確認ください。アプリケーションでより高いレート制限が必要な場合は、サポートまでご連絡ください。

サポート

Logos API の利用に関してさらにサポートが必要な場合やご不明点がある場合は、Benzinga API サポートまでお問い合わせいただくか、各エンドポイントの詳細なドキュメントを参照してください。

​はじめに

​利用可能なエンドポイント

​/logos/search

​/logos/sync

​検索フィルター

​1. シンボルでフィルタリング

​2. CIK でフィルターする

​3. ISIN でフィルタリング

​4. FIGIシェアクラスでフィルタリング

​5. CUSIP で絞り込み

​6. シンボルを通貨・国コードでフィルタリングする

​7. 取引所とシンボルでフィルタリング

​8. ISO MIC とシンボルによるフィルタ

​9. 暗号資産ロゴフィルター

​利用可能なフィールド

​追加パラメータ

​画像カスタマイズ

​ページネーション（バルク同期時のみ）

​証券の詳細

​レスポンス例

​200 成功時のレスポンス

​401 Unauthorized レスポンス

​404 Not Found レスポンス

​500 Internal Server Error のレスポンス

​認証

​ベストプラクティス

​レート制限

​サポート