Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Google Local Finder SERP בזמן אמת

Felo API Support
MIT
שרת:https://openapi.felo.ai
ספריות לקוח
Shell Curl

DataForSEO

​

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

DataForSEO פעולות

Google Local Finder SERP בזמן אמת

​

מחזיר את התוצאות המקומיות המורחבות ש-Google מציג כששאילתה היא בבירור מקומית ב-Google באופן סינכרוני. מחזיר keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ו-items. advanced הוא ברירת המחדל; בחרו regular כשהרשימה המדורגת בלבד חשובה, ו-html רק כדי לבדוק מה המנתח השמיט. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200.

מראה תמחור

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

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

גוף
application/json
  • סוג: array (object | null)[]
    • depth
      סוג: integer | null

      עומק פענוח

      שדה אופציונלי

      מספר התוצאות ב-SERP

      ערך ברירת מחדל: 10

      ערך מרבי: 100


      החשבון שלכם יחויב עבור כל SERP המכיל עד 10 תוצאות;

      הגדרת עומק מעל 10 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-10 תוצאות בהתאמה;

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

      את העלות אפשר לחשב בעמוד התמחור.

    • 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/{{low_se_name}}/languages

      דוגמה:en

    • language_name
      סוג: string

      השם המלא של שפת מנוע החיפוש

      שדה חובה אם לא מציינים language_code

      אם משתמשים בשדה הזה, אין צורך לציין language_code

      אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      דוגמה:

      English

    • location_code
      סוג: integer

      קוד מיקום מנוע החיפוש

      שדה חובה אם לא מציינים location_name או location_coordinate

      אם משתמשים בשדה הזה, אין צורך לציין location_name או location_coordinate

      אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      דוגמה:

      2840

    • 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,20z

    • location_name
      סוג: string

      השם המלא של מיקום מנוע החיפוש

      שדה חובה אם לא מציינים location_code או location_coordinate

      אם משתמשים בשדה הזה, אין צורך לציין location_code או location_coordinate

      אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      דוגמה:

      London,England,United Kingdom

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

      סינון תוצאות לפי דירוג מינימלי

      שדה אופציונלי

      ערכים אפשריים עבור desktop: 3.5, 4, 4.5;

      ערכים אפשריים עבור mobile: 2, 2.5, 3, 3.5, 4, 4.5

    • os
      סוג: string | null

      מערכת ההפעלה של המכשיר

      שדה אופציונלי

      אם תציינו desktop בשדה device, בחרו מבין הערכים הבאים: windows, macos

      ערך ברירת מחדל: windows

      אם תציינו mobile בשדה device, בחרו מבין הערכים הבאים: android, ios

      ערך ברירת מחדל: android

    • priority
      סוג: integer | null

      עדיפות המשימה

      שדה אופציונלי

      יכול לקבל את הערכים הבאים:

      1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל)

      2 – עדיפות ביצוע גבוהה


      על משימות בעדיפות ביצוע גבוהה תחויבו בתשלום נוסף.

      את העלות אפשר לחשב בעמוד התמחור.

    • tag
      סוג: string | null

      מזהה משימה שהמשתמש מגדיר

      שדה אופציונלי

      מגבלת התווים היא 255

      אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה

      תמצאו את ערך tag שצוין באובייקט data של התגובה

    • time_filter
      סוג: string | null

      סינון תוצאות לפי שעות פתיחה

      שדה אופציונלי

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

      שימו לב ש-Google עשויה לספק גם תוצאות שלא תואמות את המסנן הזה

      ערכים אפשריים: "open_now", "24_hours", "$day_value", "$day_value;$time_value";

      במקום $day_value השתמשו באחד מהערכים הבאים: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";

      במקום $time_value השתמשו באחד מהערכים הבאים: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"

      דוגמה: "tuesday;18"

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo
    • cost
      סוג: number | null פורמט: double

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

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

            סוגי תוצאות החיפוש ב-SERP
            מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP.
            סוגי פריטים אפשריים:
            local_pack

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

            פריטים בתוך הרכיב

            • סוג: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • סוג: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    מזהה מבחין
                    סוג: string | null

                    סוג הרכיב

                  • booking_url
                    סוג: string | null

                    כתובת URL של עמוד ההזמנה

                  • cid
                    סוג: string | null

                    מזהה לקוח שהוגדר על ידי Google

                  • description
                    סוג: string | null

                    תיאור הקישור

                  • domain
                    סוג: string | null

                    הדומיין של האתר שמארח את הסרטון

                  • is_paid
                    סוג: boolean | null

                    מציין אם הרכיב הוא מודעה

                  • page
                    סוג: integer | null

                    מספר עמוד תוצאות החיפוש
                    מציין את מספר עמוד ה-SERP שבו נמצא הרכיב

                  • phone
                    סוג: string | null

                    מספר טלפון

                  • position
                    סוג: string | null

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

                  • rank_absolute
                    סוג: integer | null

                    דירוג מוחלט ב-SERP
                    מיקום מוחלט מבין כל הרכיבים ב-SERP
                    תמיד שווה ל-0 עבור desktop

                  • rank_group
                    סוג: integer | null

                    דירוג קבוצה ב-SERP
                    מיקום בתוך קבוצת רכיבים עם ערכי type זהים;
                    מיקומים של רכיבים עם ערכי type שונים מושמטים מ-rank_group;
                    תמיד שווה ל-0 עבור desktop

                  • rating
                    סוג: object | null · Response36Afe1097B20_RatingInfo

                    הדירוג של הרכיב
                    דירוג הפופולריות בהתבסס על ביקורות ומוצג ב-SERP;
                    אם אין כזה, שווה ל-null

                    • rating_max
                      סוג: integer | null

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

                    • rating_type
                      סוג: string | null

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

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

                      ערך הדירוג

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

                      כמות המשוב

                  • rectangle
                    סוג: object | null · Response36Afe1097B20_AiModeRectangleInfo

                    פרמטרי מלבן
                    מכיל קואורדינטות קרטזיות וממדי פיקסלים של מקטע התוצאה ב-SERP
                    שווה ל-null אם calculate_rectangles בבקשת POST אינו מוגדר ל-true

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

                      הגובה של הרכיב בפיקסלים

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

                      הרוחב של הרכיב בפיקסלים

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

                      קואורדינטת ציר x קואורדינטת ציר x של הפינה השמאלית העליונה של מקטע התוצאה, כאשר הפינה השמאלית העליונה של המסך היא נקודת המוצא

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

                      קואורדינטת ציר y קואורדינטת ציר y של הפינה השמאלית העליונה של מקטע התוצאה, כאשר הפינה השמאלית העליונה של המסך היא נקודת המוצא

                  • title
                    סוג: string | null

                    כותרת השורה

                  • url
                    סוג: string | null

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

                  • xpath
                    סוג: string | null

                    XPath של הרכיב

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

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

          • keyword
            סוג: string | null

            מילת מפתח שהתקבלה במערך POST
            מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח)

          • language_code
            סוג: string | null

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

          • location_code
            סוג: integer | null

            קוד מיקום במערך POST

          • refinement_chips
            סוג: object | null · Response36Afe1097B20_RefinementChipsInfo

            שבבי עידון חיפוש

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

              הפריטים של הרכיב

              • domain
                סוג: string | null

                דומיין ב-SERP

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

                אפשרויות עידון חיפוש נוספות

                • domain
                  סוג: string | null

                  דומיין ב-SERP

                • title
                  סוג: string | null

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

                • type
                  סוג: string | null

                  סוג הרכיב

                • url
                  סוג: string | null

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

              • title
                סוג: string | null

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

              • type
                סוג: string | null

                סוג הרכיב

              • url
                סוג: string | null

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

            • type
              סוג: string | null

              סוג הרכיב

            • xpath
              סוג: string | null

              ה-XPath של הרכיב

          • se_domain
            סוג: string | null

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

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

            המספר הכולל של תוצאות ב-SERP

          • spell
            סוג: object | null · Response36Afe1097B20_SpellInfo

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

            • keyword
              סוג: string | null

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

            • type
              סוג: string | null

              סוג התיקון האוטומטי ערכים אפשריים: did_you_mean, showing_results_for, no_results_found_for, including_results_for הערה: Yahoo ו-Yandex תומכים רק בסוג התיקון האוטומטי הבא: including_results_for

          • type
            סוג: string | 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
Request Example for post/v1/beta/dataforseo/serp/google/local_finder/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "local nail services",
    "min_rating": 4.5,
    "time_filter": "monday"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Live Google Local Finder SERP