# إعداد مهام ‘Bulk Clickstream Search Volume’ المباشرة

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live`

**Tags:** DataForSEO

حجم بحث Clickstream لكثير من `keywords` في استدعاء واحد، دون بُعد اللغة. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في `tasks[0].result`، والنتيجة في `tasks[0].status_code` — ولا يزال الطلب المرفوض يعيد HTTP 200. البديل لكل كلمة مفتاحية مع اللغة هو `post_dataforseo_keywords_clickstream_search_volume_live`. بما أن السعر لكل استدعاء لا لكل كلمة مفتاحية، فهذه هي المناسبة للقوائم.

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

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

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

## Related links

- [هذا المقال](<https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task>)
- [مقال مركز المساعدة](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)

## 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: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>الكلمات المفتاحية المستهدفة</em><br><strong>حقل مطلوب</strong><br>ترميز UTF-8<br>الحد الأقصى لعدد الكلمات المفتاحية التي يمكنك تحديدها في هذه المصفوفة: 1000؛<br>يجب ألا تقل كل كلمة مفتاحية عن 3 أحرف؛<br>ستُحوَّل الكلمات المفتاحية إلى صيغة أحرف صغيرة؛<br><strong>ملاحظة:</strong> بعض الرموز والأحرف (مثل رموز UTF والرموز التعبيرية) غير مسموح بها<br>لمعرفة المزيد حول الرموز والأحرف التي يمكن استخدامها، راجع هذا المقال<p>تعرّف على قواعد وقيود حقلي <code>keyword</code> و<code>keywords</code> في واجهات DataForSEO API في مقال مركز المساعدة"
          },
          "location_name": {
            "type": "string",
            "description": "<em>الاسم الكامل للموقع</em><br><strong>حقل مطلوب إذا لم تحدد</strong> <code>location_code</code><br><strong>ملاحظة:</strong> يجب تحديد <code>location_name</code> أو <code>location_code</code><br>يمكنك الحصول على قائمة المواقع المتاحة مع <code>location_name</code> الخاص بها عبر إرسال طلب منفصل إلى <br><code>https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages</code><br>مثال:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>رمز الموقع</em><br><strong>حقل مطلوب إذا لم تحدد</strong> <code>location_name</code><br><strong>ملاحظة:</strong> يجب تحديد <code>location_name</code> أو <code>location_code</code><br>يمكنك الحصول على قائمة المواقع المتاحة مع <code>location_code</code> الخاص بها عبر إرسال طلب منفصل إلى <br><code>https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages</code><br>مثال:<br><code class=\"long-string\">2840</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>معرّف مهمة يحدده المستخدم</em><br>حقل اختياري<br><em>الحد الأقصى للأحرف هو 255</em><br>يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة<br>ستجد قيمة <code>tag</code> المحددة في كائن <code>data</code> ضمن الاستجابة"
          }
        },
        "example": [
          {
            "location_code": 2840,
            "tag": "test-tag",
            "keywords": [
              "you tube",
              "youtube",
              "youtub"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_code": 2840,
      "tag": "test-tag",
      "keywords": [
        "you tube",
        "youtube",
        "youtub"
      ]
    }
  ]
}
```

## Responses

### 200 — عملية ناجحة

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

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo"
    }
  ]
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "الإصدار الحالي من API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز الحالة العام\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "رسالة معلوماتية عامة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "إجمالي وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "معرّف المهمة\nمعرّف مهمة فريد في نظامنا بصيغة UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز حالة المهمة\nينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "الرسالة المعلوماتية للمهمة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد العناصر في مصفوفة result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "مسار URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "يحتوي على المعاملات نفسها التي حددتها في طلب POST"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo"
              }
            ]
          },
          "description": "<em>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResultInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>رمز الموقع في مصفوفة POST</em>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد النتائج المُعادة في مصفوفة <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataSearchVolumeLiveItem"
          }
        ]
      },
      "description": "<em>يحتوي على كلمات مفتاحية وبيانات ذات صلة</em>"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResultInfo"
              }
            ]
          },
          "description": "<em>مصفوفة نتائج</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordsDataClickstreamDataSearchVolumeLiveItem

`#/components/schemas/Response36Afe1097B20_KeywordsDataClickstreamDataSearchVolumeLiveItem`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>الكلمة المفتاحية المقدمة في طلب POST</em>"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>معدل حجم البحث الحالي لكلمة مفتاحية</em>",
      "format": "int64"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>معدلات حجم البحث الشهرية</em><br>مصفوفة كائنات تحتوي على معدلات حجم البحث في شهر معين من السنة"
    }
  }
}
```

### Response36Afe1097B20_MonthlySearchesInfo

`#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo`

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": [
        "integer",
        "null"
      ],
      "description": "السنة"
    },
    "month": {
      "type": [
        "integer",
        "null"
      ],
      "description": "الشهر"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "متوسط معدل حجم البحث الشهري"
    }
  }
}
```
