DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ניתוח תוכן – ממשק סיכום
תצוגה מסכמת של כל ציטוט של מילת מפתח ברחבי אינדקס האינטרנט. מחזיר total_count, rank, top_domains (כל אחד domain ו-count), sentiment_connotations (כעס, שמחה, אהבה, עצב, שיתוף, כיף), connotation_types (חיובי, שלילי, ניטרלי), text_categories, page_categories, page_types, countries ו-languages. זהו המוקד של משפחת התוכן: post_dataforseo_content_sentiment_analysis_live מחזיר רק את שני בלוקי הקונוטציה שכבר כלולים כאן, לכן קראו לזה במקומו אלא אם אתם רוצים במפורש את המטען הקטן יותר. לעמודים המצטטים הבודדים ולא לסיכומים השתמשו ב-post_dataforseo_content_search_live; לאותה תצוגה מסכמת לאורך זמן, ב-post_dataforseo_content_phrase_trends_live.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.0276 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- initialסוג: array (object | null)[] | null
_dataset _filters פרמטרים לסינון מערך הנתונים הראשוני
שדה אופציונלי
פרמטרי סינון ראשוניים שחלים על השדות בנקודת הקצה של החיפוש
אפשר להוסיף כמה מסננים בבת אחת (עד 8)
יש להגדיר אופרטור לוגיandאוorבין התנאים
האופרטורים הנתמכים:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not
אפשר להשתמש באופרטור%עם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": {
"snippet": ""logitech mouse"",
"main_title": "sale"
}- propertyסוג: string | null
Name
- pageסוג: array string[] | null
_type סוגי עמודים יעד
שדה אופציונלי
השתמשו בפרמטר הזה כדי לסנן את מערך הנתונים לפי סוגי עמודים
ערכים אפשריים:"ecommerce","news","blogs","message-boards","organization" - positiveסוג: number | null
_connotation _threshold סף קונוטציה חיובית
שדה אופציונלי
מצוין כסף מדד ההסתברות לסנטימנט חיובי הקשור לתוכן הציטוט
אם מציינים את השדה הזה, אובייקטconnotation_typesבתגובה יכיל רק נתונים על ציטוטים שהסתברות הסנטימנטpositiveשלהם גדולה או שווה לערך שצוין
ערכים אפשריים: מ-0עד1
ערך ברירת מחדל:0.4 - rankסוג: string | null
_scale מגדיר את הסקאלה שבה מחושבים ומוצגים ערכי
rank
שדה אופציונליאפשר להשתמש בפרמטר הזה כדי לבחור אם ערכי הדירוג מוצגים בסקאלה של 0–100 או 0–1000
ערכים אפשריים:
one_hundred— ערכי הדירוג מוצגים בסקאלה של 0–100one_thousand— ערכי הדירוג מוצגים בסקאלה של 0–1000ערך ברירת מחדל:
one_thousandמידע נוסף על אופן הפעולה של הפרמטר הזה זמין במאמר מרכז העזרה הזה
- sentimentsסוג: number | null
_connotation _threshold סף קונוטציה של סנטימנט
שדה אופציונלי
מצוין כסף מדד ההסתברות לקונוטציות סנטימנט הקשורות לתוכן הציטוט
אם מציינים את השדה הזה, אובייקטsentiment_connotationsבתגובה יכיל רק נתונים על ציטוטים ש
ההסתברות לכל סנטימנט בהם גדולה או שווה לערך שצוין
ערכים אפשריים: מ-0עד1
ערך ברירת מחדל:0.4 - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveTaskInfo
- 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).
- 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/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"internal_list_limit": 8,
"positive_connotation_threshold": 0.5
}
]'
{
"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,
"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
}
]
}
]
}