# 財務諸表を検索

**API:** Data API

**Endpoint:** `POST /v1/beta/financial/financials/search/screener`

**Tags:** Financial Data

数値条件に一致する ticker を検索します。本文には `filters`（それぞれ `field`、`operator`、`value` を持つ）と `limit` を指定します。`results` を返し、`ticker`、`currency`、`sector`、`industry`、および一致したフィルター対象フィールドを含みます。ここで ticker を事前に知らずに使える唯一のツールです。それ以外はすべて ticker を入力に取ります。フィルター可能なフィールドは `get_financial_financial_metrics` が返す指標名です。候補リストを作り、各銘柄の詳細を財務諸表や指標のツールで取得するために使います。

### 料金の参考情報

- 計量方式：成功リクエストあたりの固定コスト基準。
- 参考リクエスト見積もり：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": [
    "filters"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "default": 10,
      "description": "返す結果の最大数。"
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "field",
          "operator",
          "value"
        ],
        "properties": {
          "field": {
            "type": "string",
            "description": "フィルター条件。財務指標のフィールドには 'gt'、'lt'、'gte'、'lte'、'eq' 演算子を使用します。'ticker' と 'cik' フィールドには 'in' 演算子を使い、複数の値でフィルターします。"
          },
          "operator": {
            "type": "string",
            "enum": [
              "gt",
              "lt",
              "gte",
              "lte",
              "eq",
              "in"
            ],
            "description": "比較演算子。'in' 演算子はフィールド値が 'ticker' または 'cik' の場合にのみ使用でき、複数の値でフィルターできます。"
          },
          "value": {
            "oneOf": [
              {
                "type": "number",
                "description": "単一値演算子（gt、lt、gte、lte、eq）で比較する値"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "'in' 演算子を使用するときに比較する ticker または cik 値の配列"
              }
            ]
          }
        }
      },
      "minItems": 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": "検索条件に基づく追加の財務指標。"
        }
      }
    }
  }
}
```