# חיפוש מדדים פיננסיים ספציפיים

**API:** Data API

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

**Tags:** Financial Data

שולף פריטי שורה פיננסיים בשם על פני חברה אחת או יותר בקריאה אחת. הגוף מקבל `tickers` ו-`line_items` (שניהם חובה, שניהם מערכים), וכן `period` (annual, quarterly או ttm) ו-`limit`. מחזיר `search_results` עם שורה אחת לכל ticker ותקופה, הנושאת רק את השדות שביקשתם, לצד `report_period`, `period` ו-`currency`. השתמשו בו לבניית טבלת השוואה בלי לשלוף שלושה דוחות מלאים לכל חברה. שמות הפריטים הם אותם שמות שדות שכלי הדוחות מחזירים, לכן חפשו שם קודם אם אינכם בטוחים. לכל מה שקשור לחברה אחת השתמשו ב-`get_financial_financials`.



### מראה תמחור

- מדידה: בסיס עלות קבוע לבקשה מוצלחת.
- אומדן בקשת ייחוס: 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": "הטיקרים לחיפוש."
      },
      "minItems": 1,
      "description": "מערך של טיקרים להחלה על החיפוש."
    },
    "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 — נדרש מפתח API תקף של Felo.

### 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": "סמל הטיקר של החברה."
          },
          "report_period": {
            "type": "string",
            "format": "date",
            "description": "תקופת הדיווח של הנתונים הפיננסיים."
          },
          "period": {
            "type": "string",
            "enum": [
              "annual",
              "quarterly",
              "ttm"
            ],
            "description": "התקופה של הנתונים הפיננסיים."
          },
          "currency": {
            "type": "string",
            "description": "המטבע של הנתונים הפיננסיים."
          }
        },
        "additionalProperties": {
          "type": "string",
          "description": "מדדים פיננסיים נוספים בהתאם לקריטריוני החיפוש."
        }
      }
    }
  }
}
```
