DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Ads Advertisers پیشرفته زنده
تبلیغ‌دهندگانی را که با یک پرس‌وجو در داده شفافیت تبلیغات 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[]
- keywordنوع: stringالزامی
کلمه کلیدی برای جستجوی تبلیغ‌دهندگان
- locationنوع: integer
_code کد موقعیت موتور جستجو
- locationنوع: string
_name نام کامل موقعیت موتور جستجو
- نوع: 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_advertisers/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_name": "",
"location_code": 1
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks": [
"string"
],
"tasks[].result": [
"string"
]
}