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/on_page/keyword_density

צפיפות מילות מפתח

תדירות מילים וביטויים לאורך סריקה, כאשר keyword_length קובע את גודל ה-n-gram. מחזיר total_items_count, items_count ו-items. קורא סריקה שהסתיימה, ולכן זקוק ל-id מ-post_dataforseo_on_page_submit ומחזיר crawl_progress עם crawl_status של max_crawl_pages, pages_in_queue ו-pages_crawled — בדקו אותם לפני שמסתמכים על תוצאה קטנה, כי סריקה שעדיין רצה פשוט מדווחת על פחות. זה מתאר מה אתר אומר על עצמו; למה שהאינטרנט אומר עליו השתמשו ב-post_dataforseo_backlinks_anchors_live, ולמה שאנשים מחפשים — ב-post_dataforseo_keywords_gads_search_volume_live. 💰 חינם מהספק: שאילתה על סריקה שהסתיימה אינה עולה דבר, רק הסריקה עצמה.

מראה תמחור

מדידה: עלות תגובה מדווחת.
אומדן בקשת ייחוס: 0.012 דולר ארה״ב.
מכפיל לקוח לייחוס: 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
  אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["keyword","=","%seo%"]
  
  [["keyword","=","%seo%"], "and", ["frequency","<","6"]]
  
  [["keyword","not_like","%seo%"], "and", [["frequency",">","6"],"or",["density",">","0.02"]]]
  
  הרשימה המלאה של המסננים האפשריים זמינה בקישור הזה.
  
  אובייקט ריק
- id
  סוג: string
  
  מזהה המשימה
  שדה חובה
  אפשר לקבל את המזהה הזה בתגובה של נקודת הקצה Task POST
  דוגמה:
  "07131248-1535-0216-1000-17384017ad04"
- keyword_length
  סוג: integer
  
  מספר מילים במילת מפתח
  שדה חובה
  ערכים אפשריים:
  1, 2, 3, 4, 5
- limit
  סוג: integer | null
  
  המספר המרבי של מילות מפתח מוחזרות
  שדה אופציונלי
  ברירת מחדל: 100
  הערך המרבי: 1000
- order_by
  סוג: array string[] | null
  
  כללי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
  סוגי מיון אפשריים:
  asc - התוצאות ימוינו בסדר עולה
  desc - התוצאות ימוינו בסדר יורד
  יש להשתמש בפסיק כדי להגדיר סוג מיון
  דוגמה:
  ["frequency,desc"]
  שימו לב שאין להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון
  דוגמה:
  ["keyword,asc","frequency,desc"]
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה
- url
  סוג: string | null
  
  כתובת URL של עמוד
  שדה אופציונלי
  אם לא מציינים עמוד כאן, התוצאות יסופקו עבור האתר כולו
  אם משתמשים בשדה הזה, תגובת ה-API תכיל רק מילות מפתח מהעמוד שצוין
  יש לציין עמוד בכתובת URL מוחלטת (כולל http:// או https://)

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

סוג: object | null · Response36Afe1097B20_OnPageKeywordDensityTaskInfo
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

מערך תוצאות

crawl_progress
סוג: string | null

מצב הפעלת הסריקה
ערכים אפשריים: in_progress, finished

crawl_status
סוג: object | null · Response36Afe1097B20_CrawlStatusInfo

פרטי הפעלת הסריקה

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

המספר המרבי של עמודים לסריקה מציין את מגבלת max_crawl_pages שהגדרתם בעת הגדרת משימה

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

מספר העמודים שנסרקו

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

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

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

מערך הפריטים

density
סוג: number | null

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

frequency
סוג: integer | null

תדירות מילת המפתח
מספר הפעמים שמילת המפתח מופיעה באתר (או בעמוד אם ציינתם url)

keyword
סוג: string | null

מילת המפתח שהוחזרה

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

מספר הפריטים במערך התוצאות

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

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

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/on_page/keyword_density

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/keyword_density \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "09101923-1535-0216-0000-2389a8854b70",
    "url": "https://dataforseo.com/",
    "keyword_length": 2,
    "filters": [
      "frequency",
      ">",
      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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "frequency": null,
              "density": null
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

צפיפות מילות מפתח

אימותRequired

DataForSEO

צפיפות מילות מפתח

מראה תמחור