# استعلم محرّك إجابات بالذكاء الاصطناعي لقياس الظهور في GEO/AEO.

**API:** Data API

**Endpoint:** `POST /v1/beta/oxylabs/ai-search`

**Tags:** Oxylabs

نفّذ بحثًا متزامنًا بمساعدة الذكاء الاصطناعي باستخدام source google_search أو google_ai_mode وحقول الطلب الأخرى الموثّقة. لا تقبل نقطة النهاية هذه chatgpt أو gemini أو perplexity كمصادر متزامنة.

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

- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.00145 دولار أمريكي.
- مضاعف العميل المرجعي: 1.45. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة 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",
  "description": "جسم يُمرَّر كما هو لمحرّكات إجابات Google. يحدد `source` المحرّك؛ و`query` و`render` و`parse` و`geo_location` هي المعاملات التي تتوقعها مصادر Google. تُمرَّر المعاملات الإضافية من المنبع كما هي.",
  "additionalProperties": true,
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "google_search",
        "google_ai_mode"
      ],
      "description": "محرّك إجابات Google AI المراد الاستعلام عنه. يعيد `google_search` ميزة Google AI Overviews؛ ويعيد `google_ai_mode` وضع Google AI Mode. أما ChatGPT/Gemini/Perplexity فاستخدم النقطة الطرفية غير المتزامنة `post_oxylabs_llm` بدلًا من ذلك.",
      "example": "google_search"
    },
    "query": {
      "type": "string",
      "description": "استعلام البحث. مطلوب لـ`google_search` و`google_ai_mode`.",
      "example": "best noise cancelling headphones 2026"
    },
    "render": {
      "type": "string",
      "enum": [
        "html"
      ],
      "description": "بالنسبة إلى `google_search` و`google_ai_mode`، اضبطه على \"html\" لعرض الصفحة قبل التحليل.",
      "example": "html"
    },
    "parse": {
      "type": "boolean",
      "description": "إرجاع نتائج مُحلَّلة ومنظمة بدلًا من المخرجات الخام. يُوصى به لكل مصدر.",
      "example": true
    },
    "geo_location": {
      "type": "string",
      "description": "تحديد الموقع الجغرافي على مستوى الدولة للاستعلام، مثل \"United States\".",
      "example": "United States"
    }
  },
  "required": [
    "source"
  ]
}
```

Example:

```json
{
  "source": "google_ai_mode",
  "query": "best noise cancelling headphones 2026",
  "parse": true,
  "render": "html",
  "geo_location": "United States"
}
```

## Responses

### 200 — اكتمل الاستعلام بنجاح. تحمل `results[]` نتيجة واحدة لكل استعلام. يختلف الشكل المُحلّل داخل `content` حسب المصدر (انظر أوصاف الخصائص)؛ يعرض المثال أدناه شكل `google_search` (Google AI Overviews).

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

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "إدخال واحد لكل استعلام. يعيد استعلام واحد في Realtime نتيجة واحدة بالضبط، وهي الوحدة المحتسبة.",
      "items": {
        "type": "object",
        "properties": {
          "content": {
            "type": "object",
            "description": "حِمل الإجابة المُحلَّلة. يختلف الهيكل حسب مصدر Google:\n- `google_search` → `content.results.ai_overviews[]` مع `answer_text` و`references[]{source, url}` (كما هو موضح أدناه).\n- `google_ai_mode` → `content.citations[]{text, urls[]}`.",
            "properties": {
              "results": {
                "type": "object",
                "description": "حاوية نتائج مُحلَّلة من نوع Google.",
                "properties": {
                  "ai_overviews": {
                    "type": "array",
                    "description": "ميزة Google AI Overviews المعادة للاستعلام.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "answer_text": {
                          "type": "array",
                          "description": "الإجابة المولّدة بالذكاء الاصطناعي، مقسّمة إلى أجزاء قد تحمل مراجع مضمّنة.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "fragments": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "references": {
                                      "type": "array",
                                      "items": {}
                                    }
                                  }
                                }
                              }
                            }
                          }
                        },
                        "references": {
                          "type": "array",
                          "description": "المصادر المستشهد بها لهذه النظرة العامة.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "source": {
                                "type": "string"
                              },
                              "url": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```
