DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Ads Search المتقدم المباشر
يعيد الإعلانات النشطة مقابل كلمة مفتاحية على Google، بشكل متزامن. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. advanced هو الخيار الافتراضي؛ اختر regular عندما تكون القائمة المرتّبة هي كل المهمة، وhtml فقط للتحقق مما أسقطه المحلّل. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.02 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array object[]
- advertiserالنوع: array string[]
_ids مطلوبمعرّفات المعلنين؛ مطلوبة إذا لم يُحدد target
- locationالنوع: integer
_code رمز موقع محرك البحث
- locationالنوع: string
_coordinate إحداثيات GPS للموقع
- locationالنوع: string
_name الاسم الكامل لموقع محرك البحث
- targetالنوع: string
اسم النطاق المرتبط بحساب المعلن؛ مطلوب إذا لم يُحدد advertiser_ids
- النوع: object200
استجابة ناجحة
- النوع: numbercost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integerstatus
_code رمز الحالة العام
- النوع: stringstatus
_message رسالة معلوماتية عامة
- النوع: array string[]tasks
مصفوفة المهام
- النوع: array string[]tasks[]
.result مصفوفة نتائج SERP المباشرة
- النوع: 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/ads_search/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks": [
"string"
],
"tasks[].result": [
"string"
]
}