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
}