DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تنظیم وظایف Google Events SERP
رویدادهایی را که Google برای یک پرس‌وجو در Google نمایش می‌دهد در صف قرار می‌دهد و id وظیفه را در tasks[0].id برمی‌گرداند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. همزاد زنده فوراً پاسخ می‌دهد و برای یک پرس‌وجو ساده‌تر است؛ وقتی دسته از یک فراخوانی ابزار فراتر می‌رود از صف استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.02 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array object[]
- keywordنوع: stringالزامی
کلمه کلیدی برای جستجو
- languageنوع: string
_code کد زبان موتور جستجو
- languageنوع: string
_name نام کامل زبان موتور جستجو
- locationنوع: integer
_code کد موقعیت موتور جستجو
- locationنوع: string
_coordinate مختصات GPS یک موقعیت
- locationنوع: string
_name نام کامل موقعیت موتور جستجو
- pingbackنوع: string
_url نشانی URL اعلان تکمیل وظیفه
- postbackنوع: string
_data نوع داده postback
- postbackنوع: string
_url نشانی URL برای ارسال نتایج وظیفه
- priorityنوع: integer
اولویت وظیفه
- نوع: object200
پاسخ موفق
- نوع: numbercost
هزینه کل وظایف، دلار آمریکا
- نوع: integerstatus
_code کد وضعیت عمومی
- نوع: stringstatus
_message پیام اطلاعاتی عمومی
- نوع: array string[]tasks
آرایه اشیای وظیفه
- نوع: integertasks
_count تعداد وظایف در آرایه tasks
- نوع: integertasks
_error تعداد وظایف در آرایه tasks که با خطا بازگردانده شدند
- نوع: numbertasks[]
.cost هزینه وظیفه، دلار آمریکا
- نوع: stringtasks[]
.id شناسه وظیفه در قالب UUID
- نوع: integertasks[]
.result _count تعداد عناصر در آرایه result
- نوع: integertasks[]
.status _code کد وضعیت وظیفه
- نوع: stringtasks[]
.status _message پیام وضعیت وظیفه
- نوع: 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/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}