v0.2.0-beta

OpenAPI 3.1.0

הגדרת משימות Google AI Mode SERP

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/serp/google/ai_mode/task_post

הגדרת משימות Google AI Mode SERP

מכניס לתור את תשובת Google AI Mode לשאילתה, עם המקורות שהיא מצטטת ב-Google, ומחזיר id של משימה ב-tasks[0].id. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. התאום החי עונה מיד ופשוט יותר לשאילתה בודדת; השתמשו בתור כשהקבוצה תארך יותר מקריאת כלי אחת.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- browser_screen_height
  סוג: integer | null
  
  גובה מסך הדפדפן
  
  שדה אופציונלי
  
  אפשר להגדיר גובה מסך דפדפן מותאם כדי לחשב דירוג פיקסלים עבור מכשיר מסוים;
  
  אפשר לציין אותו בטווח הבא: 240-9999;
  
  ערך ברירת מחדל:
  
  1080 ל-desktop;
  
  640 ל-mobile ב-android;
  
  812 ל-mobile ב-iOS;
  
  הערה: כדי להשתמש בפרמטר הזה, הגדירו את calculate_rectangles ל-true
- browser_screen_resolution_ratio
  סוג: integer | null
  
  מקדם קנה מידה של מסך הדפדפן
  
  שדה אופציונלי
  
  אפשר להגדיר מקדם קנה מידה מותאם של מסך הדפדפן כדי לחשב דירוג פיקסלים עבור מכשיר מסוים;
  
  אפשר לציין אותו בטווח הבא: 0.5-3;
  
  ערך ברירת מחדל:
  
  1 ל-desktop;
  
  3 ל-mobile ב-android;
  
  3 ל-mobile ב-iOS;
  
  הערה: כדי להשתמש בפרמטר הזה, הגדירו את calculate_rectangles ל-true
- browser_screen_width
  סוג: integer | null פורמט: int64
  
  רוחב מסך הדפדפן
  
  שדה אופציונלי
  
  אפשר להגדיר רוחב מסך דפדפן מותאם כדי לחשב דירוג פיקסלים עבור מכשיר מסוים;
  
  אפשר לציין אותו בטווח הבא: 240-9999;
  
  ערך ברירת מחדל:
  
  1920 ל-desktop;
  
  360 ל-mobile ב-android;
  
  375 ל-mobile ב-iOS;
  
  הערה: כדי להשתמש בפרמטר הזה, הגדירו את calculate_rectangles ל-true
- calculate_rectangles
  סוג: boolean | null
  
  חישוב דירוג פיקסלים לרכיבי SERP בתוצאות מתקדמות
  
  שדה אופציונלי
  
  דירוג פיקסלים מתייחס למרחק בין מקטע התוצאה לפינה השמאלית העליונה של המסך;
  
  בקרו במרכז העזרה למידע נוסף>>
  
  כברירת מחדל, הפרמטר מוגדר ל-false
  
  הערה: אם מוגדר ל-true, החיוב לכל משימה יוכפל ב-2
- device
  סוג: string | null
  
  סוג מכשיר
  
  שדה אופציונלי
  
  החזרת תוצאות עבור סוג מכשיר מסוים
  
  יכול לקבל את הערכים:desktop, mobile
  
  ערך ברירת מחדל: desktop
- keyword
  סוג: string
  
  מילת מפתח
  
  שדה חובה
  
  אפשר לציין עד 700 תווים בשדה keyword
  
  כל %## יפוענח (והתו '+' יפוענח לרווח)
  
  אם אתם צריכים להשתמש בתו "%" ב-keyword, ציינו אותו כ-"%25";
  
  אם אתם צריכים להשתמש בתו "+" ב-keyword, ציינו אותו כ-"%2B"
  
  מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO APIs מופיע במאמר במרכז העזרה
- language_code
  סוג: string
  
  קוד שפה של מנוע החיפוש
  
  שדה חובה אם לא מציינים language_name;
  
  אם משתמשים בשדה הזה, אין צורך לציין language_name;
  
  אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_code על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/google/ai_mode/languages
- language_name
  סוג: string
  
  השם המלא של שפת מנוע החיפוש
  
  שדה חובה אם לא מציינים language_code;
  
  אם משתמשים בשדה הזה, אין צורך לציין language_code;
  
  אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/google/ai_mode/languages;
- location_code
  סוג: integer
  
  קוד מיקום מנוע החיפוש
  
  שדה חובה אם לא מציינים location_name או location_coordinate
  
  אם משתמשים בשדה הזה, אין צורך לציין location_name או location_coordinate
  
  אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/google/locations
  
  הערה: ראו Google Search Help לרשימת המדינות שבהן AI Mode זמין כעת
- location_coordinate
  סוג: string
  
  קואורדינטות GPS של מיקום
  
  שדה חובה אם לא מציינים location_name או location_code
  
  אם משתמשים בשדה הזה, אין צורך לציין location_name או location_code
  
  יש לציין את הפרמטר location_coordinate בפורמט "latitude,longitude,zoom"
  
  אם "zoom" לא צוין, יוחל 9z כברירת מחדל
  
  המספר המרבי של ספרות עשרוניות ב-"latitude" וב-"longitude": 7
  
  הערך המזערי של "zoom": 4z
  
  הערך המרבי של "zoom": 18z
  
  דוגמה:
  
  52.6178549,-155.352142,18z
- location_name
  סוג: string
  
  השם המלא של מיקום מנוע החיפוש
  
  שדה חובה אם לא מציינים location_code או location_coordinate
  
  אם משתמשים בשדה הזה, אין צורך לציין location_code או location_coordinate
  
  אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/google/locations
  
  הערה: ראו Google Search Help לרשימת המדינות שבהן AI Mode זמין כעת
- os
  סוג: string | null
  
  מערכת ההפעלה של המכשיר
  
  שדה אופציונלי
  
  אם תציינו desktop בשדה device, בחרו מבין הערכים הבאים: windows, macos
  
  ערך ברירת מחדל: windows
  
  אם תציינו mobile בשדה device, בחרו מבין הערכים הבאים: android, ios
  
  ערך ברירת מחדל: android
- pingback_url
  סוג: string | null
  
  כתובת URL להתראה על השלמת משימה
  
  שדה אופציונלי
  
  כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם
  
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  
  דוגמה:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded;
  
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- postback_data
  סוג: string
  
  סוג הנתונים של postback_url
  
  שדה חובה אם מצוין postback_url
  
  מתאים לפונקציה שבה השתמשתם להגדרת המשימה
  
  ערכים אפשריים:
  
  advanced, html
- postback_url
  סוג: string | null
  
  כתובת URL לשליחת תוצאות המשימה
  
  שדה אופציונלי
  
  כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל ה-postback_url שציינתם
  
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  
  דוגמה:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded;
  
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- priority
  סוג: integer | null
  
  עדיפות המשימה
  
  שדה אופציונלי
  
  יכול לקבל את הערכים הבאים:
  
  1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל)
  
  2 – עדיפות ביצוע גבוהה
  
  על משימות בעדיפות ביצוע גבוהה תחויבו בתשלום נוסף.
  את העלות אפשר לחשב בעמוד התמחור.
- tag
  סוג: string | null
  
  מזהה משימה שהמשתמש מגדיר
  
  שדה אופציונלי
  
  מגבלת התווים היא 255
  
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  
  תמצאו את ערך tag שצוין באובייקט data של התגובה

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

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

data
סוג: object | null

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

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

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

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

נתיב URL

result
סוג: object | null

מערך תוצאות
במקרה זה, הערך יהיה null

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/serp/google/ai_mode/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

הצגת סכמה

{
  "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": null
    }
  ]
}

פעולה מוצלחת

הגדרת משימות Google AI Mode SERP

אימותRequired

DataForSEO

הגדרת משימות Google AI Mode SERP

מראה תמחור