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"
]
}