DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
قائمة مواقع Google Events لواجهة SERP API
يعيد الأحداث التي يعرضها Google لاستعلام على Google. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: object200
استجابة ناجحة
- النوع: numbercost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integerstatus
_code رمز الحالة العام
- النوع: stringstatus
_message رسالة معلوماتية عامة
- النوع: array string[]tasks
مصفوفة المهام
- النوع: integertasks
_count عدد المهام في مصفوفة tasks
- النوع: integertasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: array string[]tasks[]
.result مصفوفة المواقع المتاحة
- النوع: stringtasks[]
.result[] .country _iso _code رمز الدولة وفق ISO
- النوع: integertasks[]
.result[] .location _code رمز الموقع
- النوع: integertasks[]
.result[] .location _code _parent رمز الموقع الأصلي
- النوع: stringtasks[]
.result[] .location _name اسم الموقع
- النوع: 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/locations \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].result": [
"string"
],
"tasks[].result[].location_code": 1,
"tasks[].result[].location_name": "string",
"tasks[].result[].location_code_parent": 1,
"tasks[].result[].country_iso_code": "string"
}