# 特定の財務指標を検索

**API:** Data API

**Endpoint:** `POST /v1/beta/financial/financials/search/line-items`

**Tags:** Financial Data

1 回の呼び出しで 1 社または複数社にまたがる指定の財務項目を取得します。本文には `tickers` と `line_items`（どちらも必須で配列）、さらに `period`（annual、quarterly、ttm）と `limit` を指定します。`search_results` を返し、ticker と期間ごとに 1 行で、要求したフィールドだけを `report_period`、`period`、`currency` とともに含みます。企業ごとに 3 つの完全な財務諸表を取得せずに比較表を作るために使います。項目名は財務諸表ツールが返すフィールド名と同じなので、不明な場合はそちらで確認してください。1 社のすべてが必要な場合は `get_financial_financials` を使います。

### 料金の参考情報

- 計量方式：成功リクエストあたりの固定コスト基準。
- 参考リクエスト見積もり：USD 0.02。
- 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。

参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "required": [
    "line_items",
    "tickers"
  ],
  "properties": {
    "line_items": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "検索する財務指標。"
      },
      "minItems": 1,
      "description": "検索に適用する行項目の配列。"
    },
    "tickers": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "検索する ticker。"
      },
      "minItems": 1,
      "description": "検索に適用する ticker の配列。"
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "ttm",
      "description": "財務データの期間。"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "返す結果の最大数。"
    }
  }
}
```

## Responses

### 200 — 検索成功レスポンス

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

Schema: `ResponseE40Feb4D3D6B_FinancialsSearchResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsSearchResponse`)

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_FinancialsSearchResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsSearchResponse`

```json
{
  "type": "object",
  "properties": {
    "search_results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string",
            "description": "会社の ticker シンボル。"
          },
          "report_period": {
            "type": "string",
            "format": "date",
            "description": "財務データの報告期間。"
          },
          "period": {
            "type": "string",
            "enum": [
              "annual",
              "quarterly",
              "ttm"
            ],
            "description": "財務データの期間。"
          },
          "currency": {
            "type": "string",
            "description": "財務データの通貨。"
          }
        },
        "additionalProperties": {
          "type": "string",
          "description": "検索条件に基づく追加の財務指標。"
        }
      }
    }
  }
}
```