# חיפוש אינטרנט

מצא דפי אינטרנט והחזר כותרות, קישורים וקטעים.

חפשו באינטרנט וקבלו דפי מקור לעיבוד על ידי האפליקציה שלכם. לקבלת תשובה שנוצרת יחד עם מקורות, השתמשו ב-[Chat](https://openapi.felo.ai/he/docs/data-api/guides/felo-chat.md).

כל הדוגמאות משתמשות ב-`FELO_API_KEY` מתוך [הסקירה הכללית](https://openapi.felo.ai/he/docs/data-api/guides/felo-overview.md). הקריאות משתמשות ב-**יתרת הפלטפורמה**, ולא ב-Felo Pro credits. דוגמאות התגובה הן להמחשה; תוכן חי ושדות אופציונליים משתנים.

## נקודת קצה

`POST /api/v1/data/web/search`

## בקשה

| שדה | סוג | נדרש | משמעות |
|---|---|---|---|
| `query` | string | כן | שאילתת חיפוש, 1–4,000 תווים |
| `count` | integer | לא | מספר תוצאות מבוקש, 1–50; ברירת מחדל 10 |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"retrieval augmented generation","count":3}'
```

## תגובה

HTTP 200 מחזיר את התוצאות בשורש ה-JSON:

```json
{
  "resources": [
    {"title":"Example guide","link":"https://example.com/guide","snippet":"An introduction to retrieval augmented generation."}
  ],
  "total": 1
}
```

| שדה | משמעות |
|---|---|
| `resources` | הדפים שהוחזרו; לכל אחד יש `title`, `link` ו-`snippet` |
| `total` | מספר המשאבים שהוחזרו, לא מספר הדפים הכולל באינטרנט |

`count` הוא הכמות המבוקשת, לא הבטחה שמספר מספיק של תוצאות תואמות אכן קיים. לנקודת קצה זו אין פרמטר cursor. כדי לקרוא מקור במלואו, העבירו את ה-`link` שלו ל-[קריאת אינטרנט](https://openapi.felo.ai/he/docs/data-api/guides/felo-web-read.md).

## חיוב וכשלים

יחידת החיוב היא בקשה אחת (`web.search`), לא דף אחד שהוחזר. קראו את [המחירים הנוכחיים](https://openapi.felo.ai/api/v1/data/prices). יש לטפל בשגיאת יתרה או מכסה בנפרד מתוצאה מוצלחת וריקה; ראו [חיוב ושגיאות](https://openapi.felo.ai/he/docs/data-api/guides/felo-billing.md).