DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
دریافت وظایف تکمیل‌شده Events SERP
وظایف Google events تکمیل‌شده‌ای را که در انتظار جمع‌آوری‌اند فهرست می‌کند. رایگان. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. ⚠️ به‌ندرت لازم است: فراخواننده id را که ارسال خودش برگردانده در اختیار دارد و می‌تواند مستقیم واکشی کند. این پاسخ می‌دهد چه چیزی در کل حساب آماده است.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 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[] .date _posted تاریخ ارسال وظیفه در قالب UTC
- نوع: stringtasks[]
.result[] .endpoint _advanced نشانی URL برای جمع‌آوری نتایج SERP Advanced
- نوع: stringtasks[]
.result[] .id شناسه وظیفه تکمیل‌شده
- نوع: stringtasks[]
.result[] .se موتور جستجوی مشخص‌شده هنگام تنظیم وظیفه
- نوع: stringtasks[]
.result[] .se _type نوع موتور جستجو
- نوع: stringtasks[]
.result[] .tag شناسه وظیفه تعریف‌شده توسط کاربر
- نوع: 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/tasks_ready \
--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[].id": "string",
"tasks[].result[].se": "string",
"tasks[].result[].se_type": "string",
"tasks[].result[].date_posted": "string",
"tasks[].result[].tag": "string",
"tasks[].result[].endpoint_advanced": "string"
}