# بحث الويب

اعثر على صفحات الويب وأعد العناوين والروابط والمقتطفات.

ابحث في الويب واستلم صفحات المصدر ليعالجها تطبيقك. للحصول على إجابة مُولدة مع مصادر، استخدم [Chat](https://openapi.felo.ai/ar/docs/data-api/guides/felo-chat.md).

تستخدم جميع الأمثلة `FELO_API_KEY` من [نظرة عامة](https://openapi.felo.ai/ar/docs/data-api/guides/felo-overview.md). تستخدم الاستدعاءات **رصيد المنصة**، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

## نقطة النهاية

`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` الخاص به إلى [Web Read](https://openapi.felo.ai/ar/docs/data-api/guides/felo-web-read.md).

## الفوترة والإخفاقات

وحدة الفوترة هي طلب واحد (`web.search`) وليس صفحة واحدة مُعادة. اقرأ [الأسعار الحالية](https://openapi.felo.ai/api/v1/data/prices). يجب التعامل مع خطأ الرصيد أو الحصة بشكل منفصل عن النتيجة الناجحة الفارغة؛ راجع [الفوترة والأخطاء](https://openapi.felo.ai/ar/docs/data-api/guides/felo-billing.md).