v0.2.0-beta

OpenAPI 3.1.0

ניתוח תוכן – ממשק חיפוש

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

post/v1/beta/dataforseo/content_analysis/search/live

ניתוח תוכן – ממשק חיפוש

מציג את העמודים הבודדים שמצטטים מילת מפתח, ולא את הסיכומים. כל פריט נושא url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score ו-page_category, לצד total_count ו-items_count. filters מקבל את השדות המפורטים ב-get_dataforseo_content_available_filters. לספירות והתפלגויות במקום עמודים, השתמשו ב-post_dataforseo_content_summary_live.

מראה תמחור

מדידה: עלות תגובה מדווחת.
אומדן בקשת עיון: 0.0276 דולר ארה״ב.
מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

גוף

application/json

סוג: array (object | null)[]
- filters
  סוג: array (object | null)[] | null
  
  מערך פרמטרים לסינון תוצאות
  שדה אופציונלי
  אפשר להוסיף כמה מסננים בבת אחת (עד 8)
  יש להגדיר אופרטור לוגי and או or בין התנאים
  האופרטורים הנתמכים:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
  אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["country","=", "US"]
  
  [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]
  
  [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or",
  
  ["content_info.text_category","has",10994]]]
  למידע נוסף על מסננים, ראו ממשק ניתוח תוכן - מסננים
  
  אובייקט ריק
- keyword
  סוג: string
  
  מילת מפתח יעד
  שדה חובה
  קידוד UTF-8
  מילות המפתח יומרו לאותיות קטנות;
  הערה: כדי להתאים ביטוי מדויק במקום מילת מפתח בודדת, השתמשו במירכאות כפולות ובקווים נטויים אחוריים;
  דוגמה:
  "keyword": "\"tesla palo alto\""
  
  מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO API מופיע במאמר במרכז העזרה
- keyword_fields
  סוג: object | null
  
  שדות מילות מפתח יעד ומילות מפתח יעד
  שדה אופציונלי
  השתמשו בפרמטר הזה כדי לסנן את מערך הנתונים לפי מילות מפתח ששדות מסוימים אמורים להכיל;
  השדות שאפשר לציין: title, main_title, previous_title, snippet
  אפשר לציין כמה שדות;
  הערה: כדי להתאים ביטוי מדויק במקום מילת מפתח בודדת, השתמשו במירכאות כפולות ובקווים נטויים אחוריים;
  דוגמה:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  סוג: string | null
- limit
  סוג: integer | null
  
  המספר המרבי של ציטוטים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 100
  ערך מרבי: 1000
- offset
  סוג: integer | null
  
  היסט במערך התוצאות של הציטוטים המוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 0
  אם מציינים את הערך 10, עשרת הציטוטים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור הציטוטים העוקבים
  הערה: מומלץ להשתמש בפרמטר זה רק כשמאחזרים עד 10,000 תוצאות
  לאחזור יותר מ-10,000 תוצאות, השתמשו ב-offset_token במקום.
- offset_token
  סוג: string | null
  
  טוקן היסט לבקשות עוקבות
  שדה אופציונלי
  מסופק בשדה הזהה בתגובה לכל בקשה;
  השתמשו בפרמטר הזה כדי להימנע מפסקי זמן כשמנסים לקבל יותר מ-10,000 תוצאות בבקשה אחת;
  אם תציינו את ערך offset_token הייחודי ממערך התגובה, תקבלו את התוצאות העוקבות של המשימה הראשונית;
  ערכי offset_token ייחודיים לכל משימה עוקבת
  הערה: אם מצוין offset_token בבקשה, כל שאר הפרמטרים מלבד limit לא יילקחו בחשבון בעת עיבוד המשימה
  מידע נוסף על הפרמטר הזה זמין במרכז העזרה שלנו
- order_by
  סוג: array string[] | null
  
  כללי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
  סוגי מיון אפשריים:
  asc - התוצאות ימוינו בסדר עולה
  desc - התוצאות ימוינו בסדר יורד
  יש להשתמש בפסיק כדי להגדיר סוג מיון
  דוגמה:
  ["content_info.sentiment_connotations.anger,desc"]
  כלל ברירת מחדל:
  ["content_info.sentiment_connotations.anger,desc"]
  שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להפריד בין כמה כללי מיון בפסיק
  דוגמה:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  סוג: array string[] | null
  
  סוגי עמודים יעד
  שדה אופציונלי
  השתמשו בפרמטר הזה כדי לסנן את מערך הנתונים לפי סוגי עמודים
  ערכים אפשריים:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  סוג: string | null
  
  מגדיר את הסקאלה שבה מחושבים ומוצגים הערכים domain_rank ו-url_rank
  שדה אופציונלי
  
  אפשר להשתמש בפרמטר הזה כדי לבחור אם ערכי הדירוג מוצגים בסקאלה של 0–100 או 0–1000
  
  ערכים אפשריים:
  one_hundred — ערכי הדירוג מוצגים בסקאלה של 0–100
  one_thousand — ערכי הדירוג מוצגים בסקאלה של 0–1000
  
  ערך ברירת מחדל: one_thousand
  
  מידע נוסף על אופן הפעולה של הפרמטר הזה זמין במאמר מרכז העזרה הזה
- search_mode
  סוג: string | null
  
  סוג קיבוץ התוצאות
  שדה אופציונלי
  סוגי קיבוץ אפשריים:
  as_is - מחזיר את כל הציטוטים של keyword היעד
  one_per_domain - מחזיר ציטוט אחד של keyword לכל דומיין
  ערך ברירת מחדל: as_is
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

תגובות

200
סוג: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo
cost
סוג: number | null פורמט: double

סך עלות המשימות, בדולר ארה״ב

status_code
סוג: integer | null

קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

status_message
סוג: string | null

הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

tasks
סוג: array (object | null)[] | null

מערך משימות

סוג: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
cost
סוג: number | null פורמט: double

סך עלות המשימות, בדולר ארה״ב

data
סוג: object | null

מכיל את אותם הפרמטרים שציינתם בבקשת POST

propertyName
סוג: object | null
id
סוג: string | null

מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

path
סוג: array (string | null)[] | null

נתיב URL

result
סוג: array (object | null)[] | null

מערך תוצאות

items
סוג: array (object | null)[] | null

מכיל ציטוטים ונתונים קשורים

content_info
סוג: object | null · Response36Afe1097B20_AnalysisContentInfo

מכיל נתונים על ציטוטים מה-url הנתון

author
סוג: string | null

המחבר של התוכן

connotation_types
סוג: object | null

סוגי קונוטציה
מכיל סוגי סנטימנטים (קוטביות סנטימנט) הקשורים לציטוט הנתון ומדד הסתברות לכל סוג סנטימנט
סוגי קונוטציית סנטימנט אפשריים: positive, negative, neutral

propertyName
סוג: integer | null פורמט: int64

Signed 64-bit integers (long type).

content_quality_score
סוג: integer | null

ציון איכות התוכן
הערך הזה מחושב לפי מספר המילים, המשפטים והתווים שהתוכן מכיל

content_type
סוג: string | null

סוג התוכן
דוגמה:
page_content, comment

date_published
סוג: string | null

התאריך והשעה שבהם התוכן פורסם
בפורמט UTC: "yyyy-mm-dd hh-mm-ss +00:00"
דוגמה:
2017-01-24 13:20:59 +00:00

group_date
סוג: string | null

התאריך והשעה של קבוצת הציטוטים
מציין את תאריך פרסום התוכן או את התאריך והשעה שבהם הסורק שלנו ביקר בדף לראשונה;
אפשר להשתמש בשדה הזה כדי לקבץ ציטוטים לפי תאריך ולהציג מגמות ציטוטים;
התאריך והשעה מסופקים בפורמט UTC: "yyyy-mm-dd hh-mm-ss +00:00"
דוגמה:
2017-01-24 13:20:59 +00:00

highlighted_text
סוג: string | null

טקסט מודגש מתוך snippet

language
סוג: string | null

השפה הראשית של הדומיין
כדי לקבל רשימה מלאה של השפות הזמינות, ראו את נקודת הקצה שפות

level
סוג: integer | null

רמת הכותרת title
מציין את רמת תג h מ-1 (העליונה) עד 6 (התחתונה)

main_title
סוג: string | null

כותרת העמוד

previous_title
סוג: string | null

הכותרת של בלוק התוכן הקודם

rating
סוג: object | null · Response36Afe1097B20_ContententRatingInfo

דירוג התוכן
דירוג הקשור ל-content_info

max_rating_value
סוג: number | null פורמט: double

הערך המרבי עבור שם הדירוג

name
סוג: string | null

שם הדירוג כאן תמצאו את הרכיבים הבאים: Max5, Percents, CustomMax

rating_count
סוג: integer | null פורמט: int64

מספר ההצבעות

rating_value
סוג: number | null פורמט: double

ערך הדירוג

relative_rating
סוג: number | null פורמט: double

דירוג יחסי

semantic_location
סוג: string | null

מיקום סמנטי
מציין את הרכיב הסמנטי ב-HTML שבו נמצא הציטוט של מילת המפתח היעד
דוגמה:
article, header

sentiment_connotations
סוג: object | null

קונוטציות סנטימנט
מכיל סנטימנטים (תגובות רגשיות) הקשורים לציטוט הנתון ומדד הסתברות לכל סנטימנט
קונוטציות סנטימנט אפשריות: anger, happiness, love, sadness, share, fun

propertyName
סוג: integer | null פורמט: int64

Signed 64-bit integers (long type).

snippet
סוג: string | null

מקטע תוכן

snippet_length
סוג: integer | null

אורך התווים של המקטע

social_metrics
סוג: array (object | null)[] | null

מדדי מעורבות ברשתות חברתיות
נתונים על אינטראקציות ברשתות חברתיות הקשורות לתוכן, בהתבסס על הטמעות אתרים שפותחו ונתמכות על ידי פלטפורמות הרשתות החברתיות

like_count
סוג: integer | null פורמט: int64

ספירת לייקים

type
סוג: string | null

סוג הרכיב

text_category
סוג: array integer[] | null

קטגוריית טקסט
כדי לקבל רשימה מלאה של הקטגוריות הזמינות, ראו את נקודת הקצה קטגוריות

title
סוג: string | null

הכותרת של התוצאה

country
סוג: string | null

קוד המדינה של רישום הדומיין
כדי לקבל רשימה מלאה של המדינות הזמינות, ראו את נקודת הקצה מיקומים

domain
סוג: string | null

שם הדומיין

domain_rank
סוג: integer | null

הדירוג של domain
הערך הזה מבוסס על נתוני קישורים נכנסים של הדומיין הנתון מ-DataForSEO Backlink Index;
domain_rank מחושב לפי שיטת דירוג הצמתים במסד נתונים מקושר — עיקרון שמשמש באלגוריתם Google PageRank המקורי
מידע נוסף על המדד ואופן החישוב זמין במאמר מרכז העזרה הזה

fetch_time
סוג: string | null

תאריך ושעה שבהם הסורק שלנו ביקר בעמוד
בפורמט UTC: "yyyy-mm-dd hh-mm-ss +00:00"
דוגמה:
2017-01-24 13:20:59 +00:00

language
סוג: string | null

השפה הראשית של הדומיין
כדי לקבל רשימה מלאה של השפות הזמינות, ראו את נקודת הקצה שפות

main_domain
סוג: string | null

הדומיין הראשי

page_category
סוג: array integer[] | null

מכיל את כל קטגוריות העמוד הרלוונטיות
קטגוריות מוצרים ושירותים הרלוונטיות לעמוד
כדי לקבל רשימה מלאה של הקטגוריות הזמינות, ראו את נקודת הקצה קטגוריות

page_types
סוג: array string[] | null

סוגי עמודים

ratings
סוג: array (object | null)[] | null

דירוגים שנמצאו בעמוד
כל הדירוגים שנמצאו בעמוד בהתבסס על microdata

max_rating_value
סוג: number | null פורמט: double

הערך המרבי עבור שם הדירוג

name
סוג: string | null

שם הדירוג כאן תמצאו את הרכיבים הבאים: Max5, Percents, CustomMax

rating_count
סוג: integer | null פורמט: int64

מספר ההצבעות

rating_value
סוג: number | null פורמט: double

ערך הדירוג

relative_rating
סוג: number | null פורמט: double

דירוג יחסי

score
סוג: number | null

ציון בולטות הציטוט
הערך הזה מבוסס על url_rank, domain_rank ו-keyword בנוכחותם ב-title, main_title, url ו-snippet
ככל שה-score גבוה יותר, כך הציטוט הקשור בעל ערך רב יותר

social_metrics
סוג: array (object | null)[] | null

מדדי מעורבות ברשתות חברתיות
נתונים על אינטראקציות ברשתות חברתיות הקשורות לתוכן, בהתבסס על הטמעות אתרים שפותחו ונתמכות על ידי פלטפורמות הרשתות החברתיות

like_count
סוג: integer | null פורמט: int64

ספירת לייקים

type
סוג: string | null

סוג הרכיב

spam_score
סוג: integer | null

ציון ספאם של קישורים נכנסים עבור ה-url
הערך הזה מבוסס על נתוני קישורים נכנסים של כתובת ה-URL הנתונה מ-DataForSEO Backlink Index;
מידע נוסף על אופן חישוב המדד זמין בעמוד מרכז העזרה הזה

type
סוג: string | null

סוג הרכיב

url
סוג: string | null

כתובת URL שבה נמצא הציטוט

url_rank
סוג: integer | null

הדירוג של ה-url
הערך הזה מבוסס על נתוני קישורים נכנסים של כתובת ה-URL הנתונה מ-DataForSEO Backlink Index;
url_rank מחושב לפי שיטת דירוג הצמתים במסד נתונים מקושר — עיקרון שמשמש באלגוריתם Google PageRank המקורי
מידע נוסף על המדד ואופן החישוב זמין במאמר מרכז העזרה הזה

items_count
סוג: integer | null פורמט: int64

מספר התוצאות שהוחזרו במערך items

offset_token
סוג: string | null

טוקן היסט לבקשות עוקבות
אפשר להשתמש במחרוזת שמסופקת בשדה הזה כדי לקבל את התוצאות העוקבות של המשימה הראשונית;
הערה: ערכי offset_token ייחודיים לכל משימה עוקבת

total_count
סוג: integer | null פורמט: int64

הסכום הכולל של תוצאות במסד הנתונים שלנו הרלוונטיות לבקשה שלכם

result_count
סוג: integer | null פורמט: int64

מספר הפריטים במערך result

status_code
סוג: integer | null

קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

status_message
סוג: string | null

הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

time
סוג: string | null

זמן ביצוע, בשניות

tasks_count
סוג: integer | null פורמט: int64

מספר המשימות במערך tasks

tasks_error
סוג: integer | null פורמט: int64

מספר המשימות במערך tasks שהוחזרו עם שגיאה

time
סוג: string | null

זמן ביצוע כולל, בשניות

version
סוג: string | null

הגרסה הנוכחית של ה-API
application/json
400

לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
401

נדרש מפתח API תקף של Felo.
402

לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
403

החשבון אינו מורשה לבצע את הפעולה הזו.
429

הגעתם למגבלת בקשות או לתקרת הוצאה.
502

השירות לא הצליח להשלים את הבקשה.
503

שירות ה-API או החיוב אינו זמין באופן זמני.
504

השירות פג בזמן הטיפול בבקשה.
default

תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

application/json

post/v1/beta/dataforseo/content_analysis/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "limit": 10
  }
]'

הצגת סכמה

{
  "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

ניתוח תוכן – ממשק חיפוש

אימותRequired

DataForSEO

ניתוח תוכן – ממשק חיפוש

מראה תמחור