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

Google News SERP HTML — חי

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

DataForSEO

​

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

DataForSEO פעולות

Google News SERP HTML — חי

​

מחזיר את תוצאות החדשות עבור מילת מפתח ב-Google, באופן סינכרוני. מקור הדף הגולמי ולא תוצאות מפוענחות. התגובה עטופה במעטפת של 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

      הערך המרבי: 200


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

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

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

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

    • keyword
      סוג: string

      מילת מפתח

      שדה חובה

      אפשר לציין עד 700 תווים בשדה keyword

      כל ה-%## יפוענחו (והתו '+' יפוענח לרווח)

      אם אתם צריכים להשתמש בתו "%" ב-keyword, ציינו אותו כ-"%25";

      אם אתם צריכים להשתמש בתו “+” ב-keyword, ציינו אותו כ-“%2B”;

      אם השדה הזה מכיל פרמטרים כגון 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', החיוב לכל משימה יוכפל פי 5

      הערה: שאילתות המכילות את הפרמטר ‘cache:’ אינן נתמכות ויחזירו שגיאת אימות


      מידע נוסף על הכללים והמגבלות של השדות 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,radius"

      המספר המרבי של ספרות עשרוניות ב-"latitude" וב-"longitude": 7

      הערך המזערי של "radius": 199.9 (מ״מ)

      הערך המרבי של "radius": 199999 (מ״מ)

      דוגמה:

      53.476225,-2.243572,200

    • 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

    • max_crawl_pages
      סוג: integer | null

      מגבלת סריקת עמודים

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

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

      ערך מרבי: 100

      הערה: הפרמטרים max_crawl_pages ו-depth משלימים זה את זה;

      מידע נוסף במרכז העזרה שלנו

    • os
      סוג: string | null

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

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

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

      בחרו מבין הערכים הבאים: windows, macos

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

    • se_domain
      סוג: string | null

      דומיין מנוע החיפוש

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

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

      עם זאת, אפשר להגדיר בשדה הזה דומיין מנוע חיפוש מותאם

      דוגמה:

      google.co.uk, google.com.au, google.de וכו'.

    • search_param
      סוג: string | null

      פרמטרים נוספים של שאילתת החיפוש

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

      קבלו את רשימת הפרמטרים הזמינים ופרטים נוספים כאן

    • tag
      סוג: string | null

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

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

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

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

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

    • url
      סוג: string | null

      כתובת URL ישירה של שאילתת החיפוש

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

      אפשר לציין כתובת URL ישירה ואנחנו נפרק אותה לשדות הדרושים. שימו לב שהשיטה הזו היא הקשה ביותר לעיבוד עבור ה-API שלנו וגם דורשת לציין את השפה והמיקום המדויקים בכתובת ה-URL. ברוב המקרים לא נמליץ להשתמש בשיטה הזו.

      דוגמה:

      https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

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

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

          מערך תוצאות

          • 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

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

            • date
              סוג: string | null

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

            • html
              סוג: string | null

              עמוד HTML

            • page
              סוג: integer | null

              המספר הסידורי של עמוד ה-HTML שהוחזר

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

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

          • keyword
            סוג: string | null

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

          • language_code
            סוג: string | null

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

          • location_code
            סוג: integer | null

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

          • se_domain
            סוג: string | null

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

          • 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/news/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/news/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Live Google News SERP HTML