DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
إعداد مهام Google Events SERP
يضع الأحداث التي يعرضها Google لاستعلام على Google في قائمة الانتظار ويعيد id للمهمة في tasks[0].id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. النظير المباشر يجيب فورًا وهو أبسط لاستعلام واحد؛ استخدم قائمة الانتظار عندما تتجاوز الدفعة مدة استدعاء أداة.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.02 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array object[]
- keywordالنوع: stringمطلوب
الكلمة المفتاحية المراد البحث عنها
- languageالنوع: string
_code رمز لغة محرك البحث
- languageالنوع: string
_name الاسم الكامل للغة محرك البحث
- locationالنوع: integer
_code رمز موقع محرك البحث
- locationالنوع: string
_coordinate إحداثيات GPS للموقع
- locationالنوع: string
_name الاسم الكامل لموقع محرك البحث
- pingbackالنوع: string
_url عنوان URL لإشعار اكتمال المهمة
- postbackالنوع: string
_data نوع بيانات postback
- postbackالنوع: string
_url عنوان URL لإرسال نتائج المهمة
- priorityالنوع: integer
أولوية المهمة
- النوع: object200
استجابة ناجحة
- النوع: numbercost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integerstatus
_code رمز الحالة العام
- النوع: stringstatus
_message رسالة معلوماتية عامة
- النوع: array string[]tasks
مصفوفة كائنات المهام
- النوع: integertasks
_count عدد المهام في مصفوفة tasks
- النوع: integertasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: numbertasks[]
.cost تكلفة المهمة، بالدولار الأمريكي
- النوع: stringtasks[]
.id معرّف المهمة بصيغة UUID
- النوع: integertasks[]
.result _count عدد العناصر في مصفوفة result
- النوع: integertasks[]
.status _code رمز حالة المهمة
- النوع: stringtasks[]
.status _message رسالة حالة المهمة
- النوع: stringtime
وقت التنفيذ، بالثواني
- النوع: stringversion
الإصدار الحالي من API
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/events/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}