DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
תצוגה מסכמת היסטורית של דירוג
תצוגה מסכמת של דירוג דומיין כפי שהייתה בכל נקודה בהיסטוריה הזמינה. אין כאן פרמטר limit, אך התמחור לפי קריאה ולא לפי פריט, לכן שלחו את כל הרשימה בבת אחת. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. בדקו קודם את get_dataforseo_labs_google_available_history — היא מפרטת אילו תאריכים קיימים, ובקשה לתאריך מחוצה להם מחזירה כלום ולא שגיאה. התצלום הנוכחי הוא post_dataforseo_labs_google_domain_rank_overview_live.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.1356 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- correlateסוג: boolean | null
התאמת נתונים למערכי נתונים שהתקבלו בעבר
שדה אופציונלי
ברירת מחדל:true
אם תשתמשו בפרמטר זה, המערכת שלנו תתאים את הנתונים שתקבלו כעת למערכי נתונים שהתקבלו בעבר
פרמטר זה נועד לצמצם אי-עקביות שעלולה להיגרם משינויים במסד הנתונים שלנו
אנו ממליצים תמיד להגדיר אתcorrelateל-true - dateסוג: string | null
_from תאריך ההתחלה של טווח הזמן
שדה אופציונלי
אם לא תציינו שדה זה, הנתונים יסופקו עבור 6 החודשים הקודמים
הערך המזערי האפשרי:2020-10-01
תבנית תאריך:"yyyy-mm-dd" - dateסוג: string | null
_to תאריך הסיום של טווח הזמן
שדה אופציונלי
אם לא תציינו שדה זה, ייעשה שימוש בתאריך של היום כברירת מחדל
תבנית תאריך:"yyyy-mm-dd"
דוגמה:"2021-04-01" - ignoreסוג: boolean | null
_synonyms התעלמות ממילות מפתח דומות מאוד
שדה אופציונלי
אם הערך הואtrue, יוחזרו רק נתונים המבוססים על מילות המפתח הליבה, ונתוני כל מילות המפתח הדומות מאוד יוחרגו;
ברירת מחדל:false - includeסוג: boolean | null
_clickstream _data כלילה או החרגה של נתונים ממדדים מבוססי Clickstream בתגובה
שדה אופציונלי
אם הפרמטר מוגדר ל-true, תקבלו את השדותclickstream_etv,clickstream_gender_distributionו-clickstream_age_distributionעם נתוני Clickstream בתגובה;
ברירת מחדל:false;הערה: נתוני Clickstream היסטוריים זמינים מ-2024/05 (מאי 2024);
כשהפרמטר מופעל, תחויבו במחיר כפול עבור הבקשה;
מידע נוסף על אופן חישוב המדדים מבוססי Clickstream מופיע במאמר במרכז העזרה - languageסוג: string | null
_code קוד שפה
שדה חובה אם לא מצייניםlanguage_name
הערה: יש לצייןlanguage_nameאוlanguage_code
אפשר לקבל את רשימת המיקומים הזמינים עםlanguage_codeשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
דוגמה:en - languageסוג: string
_name השם המלא של השפה
שדה חובה אם לא מצייניםlanguage_code
הערה: יש לצייןlanguage_nameאוlanguage_code
אפשר לקבל את רשימת המיקומים הזמינים עםlanguage_nameשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
דוגמה:English - locationסוג: integer
_code קוד מיקום
שדה חובה אם לא מצייניםlocation_name
הערה: יש לצייןlocation_nameאוlocation_code
אפשר לקבל את רשימת המיקומים הזמינים עםlocation_codeשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
דוגמה:2840 - locationסוג: string
_name השם המלא של המיקום
שדה חובה אם לא מצייניםlocation_code
הערה: יש לצייןlocation_nameאוlocation_code
אפשר לקבל את רשימת המיקומים הזמינים עםlocation_nameשלהם באמצעות בקשה נפרדת אלhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
דוגמה:United Kingdom - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה - targetסוג: string
דומיין
שדה חובה
שם הדומיין של אתר היעד
יש לציין את הדומיין ללאhttps://וללאwww.
- סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
- 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
נתוני דירוג הנוגעים לדומיין שצוין
- propertyסוג: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamסוג: object | null
_age _distribution - propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- clickstreamסוג: number | null פורמט: double
_etv - clickstreamסוג: object | null
_gender _distribution - propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- countסוג: integer | null פורמט: int64
הספירה הכוללת של תוצאות SERP אורגניות המכילות את הדומיין או תת-הדומיין
- estimatedסוג: number | null
_paid _traffic _cost העלות המוערכת של המרת תנועת חיפוש אורגנית לממומנת
מייצג את העלות החודשית המוערכת (בדולרים) של הפעלת מודעות עבור כל מילות המפתח בקטגוריה שהדומיין או תת-הדומיין מדורג בהם
המדד מחושב כמכפלה של ערכיetvאורגניים ו-cpcממומנים, ומציין את העלות של הבאת נפח התנועה האורגנית החודשי המוערך באמצעות פרסום PPC בחיפוש Google
מידע נוסף על אופן חישוב המדד במאמר מרכז העזרה הזה - etvסוג: number | null
- isסוג: integer | null
_down הדירוג ירד
מציין כמה רכיבים מדורגים של היעד שצוין ירדו - isסוג: integer | null
_lost רכיבים מדורגים שאבדו
מציין כמה רכיבים מדורגים של היעד שצוין הוצגו בעבר ב-SERP אך לא נמצאו בבדיקה האחרונה - isסוג: integer | null
_new מספר הרכיבים המדורגים החדשים
מציין כמה רכיבים מדורגים חדשים נמצאו עבור היעד שצוין - isסוג: integer | null
_up הדירוג עלה
מציין כמה רכיבים מדורגים של היעד שצוין עלו - posסוג: integer | null
_1 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #1
- posסוג: integer | null
_11 _20 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #11-20
- posסוג: integer | null
_2 _3 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #2-3
- posסוג: integer | null
_21 _30 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #21-30
- posסוג: integer | null
_31 _40 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #31-40
- posסוג: integer | null
_4 _10 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #4-10
- posסוג: integer | null
_41 _50 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #41-50
- posסוג: integer | null
_51 _60 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #51-60
- posסוג: integer | null
_61 _70 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #61-70
- posסוג: integer | null
_71 _80 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #71-80
- posסוג: integer | null
_81 _90 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #81-90
- posסוג: integer | null
_91 _100 מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #91-100
- monthסוג: integer | null
החודש שעבורו מסופקים הנתונים
- seסוג: string | null
_type סוג מנוע החיפוש
- yearסוג: integer | null
השנה שעבורה מסופקים הנתונים
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שהוחזרו במערך
items - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- seסוג: string | null
_type סוג מנוע החיפוש
- targetסוג: string | null
דומיין יעד במערך POST
- 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_rank_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29"
}
]'
{
"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,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"year": null,
"month": null,
"metrics": null
}
]
}
]
}
]
}