DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
הערכת תנועה מרוכזת היסטורית
תנועה אורגנית מוערכת עבור דומיינים רבים בכל נקודה בהיסטוריה הזמינה — סדרת הזמן שמאחורי post_dataforseo_labs_google_bulk_traffic_estimation_live. אין כאן פרמטר limit, אך התמחור לפי קריאה ולא לפי פריט, לכן שלחו את כל הרשימה בבת אחת. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ⚠️ גודל התגובה מכפיל דומיינים בתאריכים; שמרו על שתי הרשימות קצרות. התאריכים הזמינים מגיעים מ-get_dataforseo_labs_google_available_history.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.1356 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- dateסוג: string | null
_from תאריך ההתחלה של טווח הזמן
שדה אופציונלי
אם לא תציינו שדה זה, הנתונים יסופקו עבור 12 החודשים הקודמים
הערך המזערי האפשרי:2020-10-01
תבנית תאריך:"yyyy-mm-dd" - dateסוג: string | null
_to תאריך הסיום של טווח הזמן
שדה אופציונלי
אם לא תציינו שדה זה, ייעשה שימוש בתאריך של היום כברירת מחדל;
תבנית תאריך:"yyyy-mm-dd"
דוגמה:"2021-04-01" - ignoreסוג: boolean | null
_synonyms התעלמות ממילות מפתח דומות מאוד
שדה אופציונלי
אם הערך הואtrue, יוחזרו רק מילות המפתח הליבה וכל מילות המפתח הדומות מאוד יוחרגו;
ברירת מחדל:false - itemסוג: array string[] | null
_types הצגת תוצאות לפי סוג פריט
שדה אופציונלי
מציין את סוג תוצאות החיפוש שנכללות בתגובה;
הערה: אם מערךitem_typesמכיל סוגי פריטים שונים מ-organic, התוצאות ימוינו לפי סוג הפריט הראשון במערך;
ערכים אפשריים:["organic", "paid", "featured_snippet", "local_pack"]
ברירת מחדל:["organic", "paid"] - languageסוג: string | null
_code קוד שפה
אם תשתמשו בשדה זה, אין צורך לצייןlanguage_name
אפשר לקבל את רשימת השפות הזמינות עםlanguage_codeשלהן באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
התעלמו משדה זה כדי לקבל תוצאות עבור כל השפות הזמינות
דוגמה:en - languageסוג: string | null
_name השם המלא של השפה
אם תשתמשו בשדה זה, אין צורך לצייןlanguage_code
אפשר לקבל את רשימת השפות הזמינות עםlanguage_nameשלהן באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
התעלמו משדה זה כדי לקבל תוצאות עבור כל השפות הזמינות
דוגמה:English - locationסוג: integer | null
_code קוד מיקום
אם תשתמשו בשדה זה, אין צורך לצייןlocation_name
אפשר לקבל את רשימת המיקומים הזמינים עםlocation_codeשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
התעלמו משדה זה כדי לקבל תוצאות עבור כל המיקומים הזמינים
דוגמה:2840 - locationסוג: string | null
_name השם המלא של המיקום
אם תשתמשו בשדה זה, אין צורך לצייןlocation_code
אפשר לקבל את רשימת המיקומים הזמינים עםlocation_nameשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
התעלמו משדה זה כדי לקבל תוצאות עבור כל המיקומים הזמינים
דוגמה:United Kingdom - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה - targetsסוג: array string[]
דומיינים ותת-דומיינים של יעד
שדה חובה
אפשר לציין דומיינים ותת-דומיינים בשדה זה;
יש לציין דומיינים ותת-דומיינים ללאhttps://וללאwww.;
אפשר להגדיר עד 1000 דומיינים או תת-דומיינים
- סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: array (object | null)[] | null
מערך תוצאות
- itemsסוג: array (object | null)[] | null
מערך של פריטים עם נתוני הערכת תנועה רלוונטיים
- metricsסוג: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo
נתוני תנועה הנוגעים לדומיין שצוין
- featuredסוג: array (object | null)[] | null
_snippet נתוני תנועה מתוצאות הקטע המוביל ב-Google SERP
- countסוג: integer | null פורמט: int64
ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין
- etvסוג: number | null
- monthסוג: integer | null
החודש שעבורו מסופקים הנתונים
- yearסוג: integer | null
השנה שעבורה מסופקים הנתונים
- localסוג: array (object | null)[] | null
_pack נתוני תנועה מתוצאות החבילה המקומית ב-SERP
- countסוג: integer | null פורמט: int64
ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין
- etvסוג: number | null
- monthסוג: integer | null
החודש שעבורו מסופקים הנתונים
- yearסוג: integer | null
השנה שעבורה מסופקים הנתונים
- organicסוג: array (object | null)[] | null
נתוני תנועה מחיפוש אורגני
- countסוג: integer | null פורמט: int64
ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין
- etvסוג: number | null
- monthסוג: integer | null
החודש שעבורו מסופקים הנתונים
- yearסוג: integer | null
השנה שעבורה מסופקים הנתונים
- paidסוג: array (object | null)[] | null
נתוני תנועה מחיפוש בתשלום
- countסוג: integer | null פורמט: int64
ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין
- etvסוג: number | null
- monthסוג: integer | null
החודש שעבורו מסופקים הנתונים
- yearסוג: integer | null
השנה שעבורה מסופקים הנתונים
- seסוג: string | null
_type סוג מנוע החיפוש
- targetסוג: string | null
דומיין יעד במערך POST
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שהוחזרו במערך
items - languageסוג: string | null
_code קוד שפה במערך POST
אם אין נתונים, הערך הואnull - locationסוג: integer | null
_code קוד מיקום במערך POST
אם אין נתונים, הערך הואnull - seסוג: string | null
_type סוג מנוע החיפוש
- totalסוג: integer | null פורמט: int64
_count הסכום הכולל של תוצאות במסד הנתונים שלנו הרלוונטיות לבקשה שלכם
- resultסוג: integer | null פורמט: int64
_count מספר הפריטים במערך result
- statusסוג: integer | null
_code קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- statusסוג: string | null
_message הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- timeסוג: string | null
זמן ביצוע, בשניות
- סוג: integer | null פורמט: int64tasks
_count מספר המשימות במערך tasks
- סוג: integer | null פורמט: int64tasks
_error מספר המשימות במערך tasks שהוחזרו עם שגיאה
- סוג: string | nulltime
זמן ביצוע כולל, בשניות
- סוג: string | nullversion
הגרסה הנוכחית של ה-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/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"dataforseo.com",
"cnn.com",
"forbes.com"
],
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29",
"item_types": [
"organic",
"paid"
]
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"target": null,
"metrics": "[Max Depth Exceeded]"
}
]
}
]
}
]
}