DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ניתוח תוכן – ממשק מגמות ביטויים
המדדים המסכמים של מילת מפתח, חוזרים לכל תקופת זמן. כל רשומה נושאת date יחד עם total_count, rank, top_domains (כל אחד domain ו-count), sentiment_connotations (כעס, שמחה, אהבה, עצב, שיתוף, כיף), connotation_types (חיובי, שלילי, ניטרלי), text_categories, page_categories, page_types, countries ו-languages. date_from, date_to ו-date_group (day, week, month) קובעים את הטווח ואת הפירוט. השתמשו בזה כדי לראות אם אזכורים של ביטוי עולים או יורדים; לנקודת זמן אחת השתמשו ב-post_dataforseo_content_summary_live. כדי לעקוב אחר קטגוריית מוצר שלמה ולא ביטוי אחד, השתמשו ב-post_dataforseo_content_category_trends_live.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.0276 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- dateסוג: string
_from תאריך התחלה של טווח הזמנים
שדה חובה
תבנית תאריך:"yyyy-mm-dd"
דוגמה:"2019-01-15" - dateסוג: string | null
_group טווח הזמנים שישמש לקיבוץ התוצאות
שדה אופציונלי
ערך ברירת מחדל:month
ערכים אפשריים:day,week,month - dateסוג: string | null
_to תאריך סיום של טווח הזמנים
שדה אופציונלי
אם לא מציינים את השדה הזה, ייעשה שימוש בתאריך של היום כברירת מחדל
תבנית תאריך:"yyyy-mm-dd"
דוגמה:"2019-01-15" - initialסוג: array (object | null)[] | null
_dataset _filters פרמטרים לסינון מערך הנתונים הראשוני
שדה אופציונלי
פרמטרי סינון ראשוניים שחלים על השדות בנקודת הקצה של החיפוש;
אפשר להוסיף כמה מסננים בבת אחת (עד 8);
יש להגדיר אופרטור לוגיandאוorבין התנאים;
האופרטורים הנתמכים:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
אפשר להשתמש באופרטור%עםlikeו-not_likeכדי להתאים כל מחרוזת של אפס תווים או יותר;
דוגמה:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
למידע נוסף על מסננים, ראו ממשק ניתוח תוכן - מסננים
מידע נוסף על מסנני מערך הנתונים הראשוני מופיע במאמר מרכז העזרה הזה.אובייקט ריק - internalסוג: integer | null
_list _limit המספר המרבי של פריטים במערכים פנימיים
שדה אופציונלי
אפשר להשתמש בשדה הזה כדי להגביל את מספר הפריטים במערכים הבאים:top_domainstext_categoriespage_categoriescountrieslanguages
ערך ברירת מחדל:1
ערך מרבי:20 - keywordסוג: string
- keywordסוג: object | null
_fields שדות מילות מפתח יעד ומילות מפתח יעד
שדה אופציונלי
השתמשו בפרמטר הזה כדי לסנן את מערך הנתונים לפי מילות מפתח ששדות מסוימים אמורים להכיל;
השדות שאפשר לציין:title,main_title,previous_title,snippet
אפשר לציין כמה שדות;
הערה: כדי להתאים ביטוי מדויק במקום מילת מפתח בודדת, השתמשו במירכאות כפולות ובקווים נטויים אחוריים;
דוגמה:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}- propertyסוג: string | null
Name
- pageסוג: array string[] | null
_type סוגי עמודים יעד
שדה אופציונלי
השתמשו בפרמטר הזה כדי לסנן את מערך הנתונים לפי סוגי עמודים
ערכים אפשריים:"ecommerce","news","blogs","message-boards","organization" - rankסוג: string | null
_scale מגדיר את הסקאלה שבה מחושבים ומוצגים ערכי
rank
שדה אופציונליאפשר להשתמש בפרמטר הזה כדי לבחור אם ערכי הדירוג מוצגים בסקאלה של 0–100 או 0–1000
ערכים אפשריים:
one_hundred— ערכי הדירוג מוצגים בסקאלה של 0–100one_thousand— ערכי הדירוג מוצגים בסקאלה של 0–1000ערך ברירת מחדל:
one_thousandמידע נוסף על אופן הפעולה של הפרמטר הזה זמין במאמר מרכז העזרה הזה
- searchסוג: string | null
_mode סוג קיבוץ התוצאות
שדה אופציונלי
סוגי קיבוץ אפשריים:as_is- מחזיר נתונים על כל הציטוטים שלkeywordהיעדone_per_domain- מחזיר נתונים על ציטוט אחד שלkeywordלכל דומיין
ערך ברירת מחדל:as_is - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveTaskInfo
- 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
מערך תוצאות
- connotationסוג: object | null
_types סוגי קונוטציה
מכיל סוגי סנטימנטים (קוטביות סנטימנט) הקשורים לציטוט מילת המפתח ומספר ציטוטים לכל סוג סנטימנט
סוגי קונוטציה אפשריים:"positive","negative","neutral"- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- countriesסוג: object | null
- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- dateסוג: string | null
התאריך שעבורו מסופקים הנתונים
- languagesסוג: object | null
- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- pageסוג: array (object | null)[] | null
_categories - categoryסוג: array (integer | null)[] | null
- countסוג: integer | null פורמט: int64
Signed 64-bit integers (long type).
- pageסוג: object | null
_types סוגי עמודים
מכיל סוגי עמודים ומספר ציטוטים לכל סוג עמוד- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- rankסוג: integer | null
הדירוג של כל כתובות ה-URL שמצטטות את
keyword
סכום מנורמל של הדירוגים של כל כתובות ה-URL שמצטטות את ה-keywordהיעד בתאריך הנתון - sentimentסוג: object | null
_connotations קונוטציות סנטימנט
מכיל סנטימנטים (תגובות רגשיות) הקשורים לציטוט מילת המפתח היעד ומספר הציטוטים לכל סנטימנט
קונוטציות אפשריות:"anger","happiness","love","sadness","share","fun"- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- textסוג: array (object | null)[] | null
_categories - categoryסוג: array (integer | null)[] | null
- countסוג: integer | null פורמט: int64
Signed 64-bit integers (long type).
- topסוג: array (object | null)[] | null
_domains הדומיינים המובילים שמצטטים את מילת המפתח היעד
מכיל אובייקטים עם הדומיינים המובילים שמצטטים את מילת המפתח היעד ומספר ציטוטים לכל דומיין- countסוג: integer | null פורמט: int64
Signed 64-bit integers (long type).
- domainסוג: string | null
- totalסוג: integer | null פורמט: int64
_count המספר הכולל של תוצאות במסד הנתונים שלנו הרלוונטיות לבקשה שלכם
- typeסוג: string | null
סוג הרכיב
- 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/content_analysis/phrase_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"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": [
{
"type": null,
"date": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}