# البحث على الويب

**API:** Data API

**Endpoint:** `POST /v1/beta/scholar/search/web`

**Tags:** Scholar Search

ابحث في الويب المفتوح واحصل على قائمة نتائج موجزة. ⚠️ رغم أنه POST، تذهب المعاملات في **سلسلة الاستعلام** — `query` (مطلوب)، و`max_num_results` (الافتراضي 10، والحد الأقصى 100)، و`as_ylo`/`as_yhi` لنطاق سنة. لا يُقبل جسم JSON. يعيد `id` بحث و`results[]` تحمل فقط `title` و`link` و`snippet`. ميزته قلّة ما يعيده، ما يناسب وكيلًا يحتاج فقط إلى معرفة ما هو موجود. لا يمنحك نص الصفحة — إذا احتجت إلى المحتوى، يعيده `searchWeb` في الاستدعاء نفسه. احتفظ بـ`id`: فهو ما يحتاجه `post_scholar_search_explain`.

### مرجع التسعير

- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.01 دولار أمريكي.
- مضاعف العميل المرجعي: 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`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `as_yhi` | query | no | integer \| null | الحد الأعلى لسنة النشر |
| `as_ylo` | query | no | integer \| null | الحد الأدنى لسنة النشر |
| `max_num_results` | query | no | integer, default: 10 | الحد الأقصى لعدد نتائج البحث المراد إرجاعها، حتى 100 |
| `query` | query | yes | string | استعلام البحث عن مواد أكاديمية |

## Responses

### 200 — استجابة بحث ناجحة

Headers:
- `X-Request-Id` (string) — معرّف الطلب المراد تضمينه عند التواصل مع دعم Felo.

**application/json**

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

### 400 — تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

### 401 — مطلوب مفتاح API صالح من Felo.

### 402 — لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

### 403 — الحساب غير مصرّح له بهذه العملية.

### 429 — تم بلوغ حد الطلبات أو حد الإنفاق.

### 502 — تعذّر على الخدمة إكمال الطلب.

### 503 — خدمة API أو الفوترة غير متاحة مؤقتًا.

### 504 — انتهت مهلة الخدمة أثناء معالجة الطلب.

### default — استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response8Da310D1D213_WebResult

`#/components/schemas/Response8Da310D1D213_WebResult`

```json
{
  "type": "object",
  "required": [
    "title",
    "link",
    "snippet"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "عنوان صفحة الويب"
    },
    "link": {
      "type": "string",
      "format": "uri",
      "description": "عنوان URL للوصول إلى صفحة الويب"
    },
    "snippet": {
      "type": "string",
      "description": "ملخص موجز أو معاينة لمحتوى صفحة الويب"
    },
    "display_url": {
      "type": "string",
      "description": "عنوان URL مناسب للعرض"
    },
    "published_date": {
      "type": "string",
      "format": "date-time",
      "description": "تاريخ نشر صفحة الويب"
    }
  }
}
```

### Response8Da310D1D213_WebSearchResponse

`#/components/schemas/Response8Da310D1D213_WebSearchResponse`

```json
{
  "type": "object",
  "required": [
    "id",
    "results"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "معرّف فريد لطلب البحث"
    },
    "results": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response8Da310D1D213_WebResult"
      },
      "description": "قائمة نتائج البحث على الويب"
    }
  }
}
```
