v0.2.0-beta

OpenAPI 3.1.0

קבלת תוצאות ביקורות Tripadvisor לפי id

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

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

DataForSEO פעולות

get/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/{id}

קבלת תוצאות ביקורות Tripadvisor לפי id

מאחזר ביקורות Tripadvisor שנכנסו לתור עבור נכס אחד לפי id. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ⚠️ הגודל נקבע לפי depth שהוגדר בשליחה ואי אפשר לצמצם אותו בזמן האחזור.

מראה תמחור

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

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

פרמטרי נתיב

id
סוג: string
חובה

מזהה המשימה
מזהה משימה ייחודי במערכת שלנו בפורמט UUID
אפשר להשתמש בו במשך 30 יום כדי לבקש את תוצאות המשימה בכל עת

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

מערך תוצאות

check_url
סוג: string | null

כתובת URL ישירה לתוצאות מנוע החיפוש
אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות

datetime
סוג: string | null

התאריך והשעה שבהם התוצאה התקבלה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:
2019-11-15 12:57:46 +00:00

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

ביקורות שנמצאו
אפשר לקבל תוצאות נוספות באמצעות הפרמטר depth בעת הגדרת משימה

date_of_visit
סוג: string | null

התאריך שבו ביקר המבקר במוסד המקומי
בפורמט UTC: "yyyy-mm-dd hh-mm-ss +00:00"
דוגמה:
2019-11-15 12:57:46 +00:00

language
סוג: string | null

שפת טקסט הביקורת

original_language
סוג: string | null

שפת טקסט הביקורת ללא תרגום

position
סוג: string | null

יישור הביקורת ב-SERP
יכול לקבל את הערכים הבאים: right

rank_absolute
סוג: integer | null

דירוג מוחלט מבין כל הביקורות המופיעות ברשימה
מיקום מוחלט מבין כל הביקורות ברשימה

rank_group
סוג: integer | null

מיקום בתוך קבוצת רכיבים עם ערכי type זהים
מיקומים של רכיבים עם ערכי type שונים מושמטים מ-rank_group

rating
סוג: object | null · Response36Afe1097B20_RatingInfo

ציון הדירוג כפי שנשלח על ידי המבקר

rating_max
סוג: integer | null

הערך המקסימלי של rating_type

rating_type
סוג: string | null

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

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

ערך הדירוג

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

כמות המשוב

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

מכיל מידע על תגובת הבעלים

text
סוג: string | null

התוכן של התגובה

timestamp
סוג: string | null

זמן הפרסום

title
סוג: string | null

הכותרת של התגובה

review_highlights
סוג: object | null

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

review_id
סוג: string | null

מזהה הביקורת

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

מכיל כתובות URL של התמונות שבהן נעשה שימוש בביקורת

url
סוג: string | null

כתובת URL של התמונה המשמשת בביקורת

review_text
סוג: string | null

תוכן הביקורת

timestamp
סוג: string | null

התאריך והשעה שבהם פורסמה הביקורת
בפורמט UTC: "yyyy-mm-dd hh-mm-ss +00:00"
דוגמה:
2019-11-15 12:57:46 +00:00

title
סוג: string | null

כותרת הביקורת

type
סוג: string | null

סוג הרכיב

url
סוג: string | null

כתובת URL של הביקורת

user_profile
סוג: object | null · Response36Afe1097B20_BusinessDataUserProfileInfo

מידע מהפרופיל של המבקר

image_url
סוג: string | null
location
סוג: string | null
name
סוג: string | null
reviews_count
סוג: integer | null פורמט: int64

המספר הכולל של ביקורות שהוגשו על ידי המבקר

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

מספר פריטי הביקורות במערך התוצאות
אפשר לקבל תוצאות נוספות באמצעות הפרמטר depth בעת הגדרת משימה

language_code
סוג: string | null

קוד שפה במערך POST

location
סוג: string | null

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

rating
סוג: object | null · Response36Afe1097B20_RatingInfo

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

rating_max
סוג: integer | null

הערך המקסימלי של rating_type

rating_type
סוג: string | null

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

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

ערך הדירוג

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

כמות המשוב

rating_distribution
סוג: object | null

התפלגות הדירוג לפי הצבעות
התפלגות ההצבעות על פני הדירוג בטווח שבין 1 ל-5

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

מספר הביקורות הכולל

se_domain
סוג: string | null

דומיין מנוע החיפוש במערך POST

title
סוג: string | null

הכותרת של רכיב 'reviews' ב-SERP
השם של המוסד המקומי שעבורו נאספות הביקורות

type
סוג: string | null

סוג הרכיב

url_path
סוג: string | null

נתיב URL שהתקבל במערך POST

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

get/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

הצגת סכמה

{
  "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": [
        {
          "url_path": null,
          "type": null,
          "se_domain": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "location": null,
          "reviews_count": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "rating_distribution": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "url": null,
              "rating": "[Max Depth Exceeded]",
              "date_of_visit": null,
              "timestamp": null,
              "review_id": null,
              "title": null,
              "review_text": null,
              "language": null,
              "original_language": null,
              "review_images": [
                "[Max Depth Exceeded]"
              ],
              "user_profile": "[Max Depth Exceeded]",
              "responses": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": null
            }
          ],
          "language_code": null
        }
      ]
    }
  ]
}

פעולה מוצלחת

קבלת תוצאות ביקורות Tripadvisor לפי id

אימותRequired

DataForSEO

קבלת תוצאות ביקורות Tripadvisor לפי id

מראה תמחור