הגדרת משימות ‘Clickstream Global Search Volume’ בזמן אמת
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
הגדרת משימות ‘Clickstream Global Search Volume’ בזמן אמת
נפח חיפוש Clickstream עבור keywords בכל העולם, ללא ארגומנט מיקום כלל — הסכום הגלובלי והפילוח לפי מדינה. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. השתמשו בו כדי להחליט אילו שווקים שווים קריאה לפי מיקום; הווריאנט עם מיקום הוא post_dataforseo_keywords_clickstream_search_volume_live.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.09 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- keywordsסוג: array string[]
מילות מפתח יעד
שדה חובה
קידוד UTF-8
המספר המרבי של מילות מפתח שאפשר לציין במערך הזה: 1000;
כל מילת מפתח צריכה להיות באורך של 3 תווים לפחות;
מילות המפתח יומרו לפורמט אותיות קטנות;
הערה: סמלים ותווים מסוימים (למשל סמלי UTF, אימוג׳י) אינם מותרים
מידע נוסף על אילו סמלים ותווים אפשר להשתמש זמין במאמר הזהמידע נוסף על הכללים והמגבלות של השדות
keywordו-keywordsב-DataForSEO API מופיע במאמר במרכז העזרה - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataGlobalSearchVolumeLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataGlobalSearchVolumeLiveTaskInfo
- 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
מכיל מילות מפתח ונתונים קשורים
- countryסוג: array (object | null)[] | null
_distribution התפלגות Clickstream לפי מדינות
מייצג נפח חיפוש מבוסס Clickstream במדינות הזמינות, וכן את האחוז המתאים שלו מנפח החיפוש העולמי- countryסוג: string | null
_iso _code קוד ISO של המדינה
- percentageסוג: number | null
אחוז מנפח החיפוש העולמי
- searchסוג: integer | null פורמט: int64
_volume שיעור נפח חיפוש חודשי ממוצע מבוסס Clickstream
מייצג את המספר (המשוער) של חיפושים אחר רעיון מילת המפתח הנתון בהתבסס על Clickstream
מידע נוסף על נפח חיפוש Clickstream במאמר מרכז העזרה הזה
- keywordסוג: string | null
מילת מפתח
מילת המפתח מוחזרת עם %## מפוענח (סימן הפלוס '+' יפענח לתו רווח) - searchסוג: integer | null פורמט: int64
_volume שיעור נפח חיפוש חודשי ממוצע מבוסס Clickstream
מייצג את המספר (המשוער) של חיפושים אחר רעיון מילת המפתח הנתון בהתבסס על Clickstream
מידע נוסף על נפח חיפוש Clickstream במאמר מרכז העזרה הזה
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות שהוחזרו במערך
items
- 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/keywords_data/clickstream_data/global_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"tag": "test-tag",
"keywords": [
"you tube",
"youtube",
"youtub"
]
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"keyword": null,
"search_volume": null,
"country_distribution": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}