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

הגדרת משימות Google Organic 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 Organic SERP

​

מכניס לתור את התוצאות המדורגות עבור מילת מפתח ב-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

      הערה: תחויבו בתוספת של 0.0006 דולר עבור שימוש בפרמטר הזה

    • depth
      סוג: integer | null

      עומק פענוח

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

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

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

      הערך המרבי: 700


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

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

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

    • device
      סוג: string | null

      סוג מכשיר

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

      החזרת תוצאות עבור סוג מכשיר מסוים

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

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

    • expand_ai_overview
      סוג: boolean | null

      הרחבת סקירת AI

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

      הגדירו ל-true כדי להרחיב את הפריט ai_overview;

      ערך ברירת מחדל: false;

      הערה: הפרמטר הזה חל רק על תוצאות משימות מסוג HTML

    • find_targets_in
      סוג: array string[] | null

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

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

      כדי להפעיל את הפרמטר הזה, יש גם להפעיל את stop_crawl_on_match

      מגדיר אילו סוגי רכיבי SERP ייבדקו לאיתור התאמות יעד

      אם לא מצוין, כל רכיבי הרמה הראשונה עם השדות url ו-domain נבדקים לאיתור יעדים

      ערכים אפשריים: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      הערה: לא יכול להכיל את אותם סוגי רכיבים כמו ignore_targets_in

      דוגמה:

      "find_targets_in": ["organic", "featured_snippet"]

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

    • group_organic_results
      סוג: boolean | null

      הצגת תוצאות קשורות

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

      אם הערך הוא true, רכיב related_result בתגובה יסופק כמקטע של תוצאת ה-organic האב שלו;

      אם הערך הוא false, רכיב related_result יסופק כתוצאת organic נפרדת;

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

    • ignore_targets_in
      סוג: array string[] | null

      סוגי רכיבי SERP שיש להוציא מחיפוש היעדים

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

      כדי להפעיל את הפרמטר הזה, יש גם להפעיל את stop_crawl_on_match

      מגדיר אילו סוגי רכיבי SERP יוחרגו בעת חיפוש התאמות יעד

      ערכים אפשריים: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      הערה: לא יכול להכיל את אותם סוגי רכיבים כמו find_targets_in

      דוגמה:

      "ignore_targets_in": ["paid", "images"]

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

    • keyword
      סוג: string

      מילת מפתח

      שדה חובה

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

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

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

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

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

      מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO APIs במאמר מרכז העזרה הזה

    • language_code
      סוג: string

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

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

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

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

      דוגמה:

      en

    • language_name
      סוג: string

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

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

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

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

      דוגמה:

      English

    • load_async_ai_overview
      סוג: boolean | null

      טעינת סקירת AI באופן אסינכרוני

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

      הגדירו ל-true כדי לקבל פריטי ai_overview ב-SERP גם אם הם נטענים באופן אסינכרוני;

      אם הערך הוא false, תקבלו פריטי ai_overview רק מהמטמון;

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

      הערה: תחויבו בתוספת של 0.0006 דולר עבור שימוש בפרמטר הזה;

      אם הרכיב חסר או מכיל "asynchronous_ai_overview": false, כל החיובים הנוספים יוחזרו ליתרת החשבון שלכם

    • location_code
      סוג: integer

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

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

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

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

      דוגמה:

      2840

    • location_coordinate
      סוג: string

      קואורדינטות GPS של מיקום

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

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

      את הפרמטר location_coordinate יש לציין בפורמט "latitude,longitude,radius"

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

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

      הערך המרבי של "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/google/locations

      דוגמה:

      London,England,United Kingdom

    • match_type
      סוג: string

      סוג התאמת היעד

      שדה חובה אם צוין stop_crawl_on_match

      סוג ההתאמה עבור match_value

      ערכים אפשריים:

      domain – דומיין או תת-דומיין מסוים

      with_subdomains – הדומיין הראשי ותת-הדומיינים

      wildcard – תבנית תו כללי

    • match_value
      סוג: string

      ערך יעד של דומיין, תת-דומיין או תו כללי

      שדה חובה אם צוין stop_crawl_on_match

      ציינו דומיין, תת-דומיין או ערך תו כללי של יעד;

      הערה: יש לציין דומיין או תת-דומיין בלי פרוטוקול בקשה;

      דוגמה: "match_value": "dataforseo.com",

      "match_value": "/blog/post-*"

    • max_crawl_pages
      סוג: integer | null

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

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

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

      הערך המרבי: 100

      הערה: תחויבו עבור כל עמוד שייסרק (10 תוצאות אורגניות לעמוד);

      מידע נוסף על התמחור בעמוד התמחור;

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

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

    • os
      סוג: string | null

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

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

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

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

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

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

    • people_also_ask_click_depth
      סוג: integer | null

      קליקים על הרכיב המתאים

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

      ציינו את עומק הקליקים על רכיב people_also_ask כדי לקבל פריטי people_also_ask_element נוספים;

      הערה החשבון שלכם יחויב בתוספת של 0.00015 דולר עבור כל קליק, ללא תלות בעדיפות המשימה;

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

      ערכים אפשריים: מ-1 עד 4

    • 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

      מתאים לסוג הנתונים שיישלח לשרת שלכם

      ערכים אפשריים:

      regular, 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 – עדיפות ביצוע גבוהה


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

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

    • remove_from_url
      סוג: array string[] | null

      הסרת פרמטרים מסוימים מכתובות URL

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

      באמצעות השדה הזה אפשר לציין עד 10 פרמטרים להסרה מכתובות URL בתוצאה

      דוגמה:

      "remove_from_url": ["srsltid"]

    • se_domain
      סוג: string | null

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

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

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

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

      דוגמה:

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

    • search_param
      סוג: string | null

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

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

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


      הערה: פרמטרי מנוע החיפוש הבאים אינם נתמכים ויבוטלו אוטומטית אם יצוינו: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
    • stop_crawl_on_match
      סוג: array (object | null)[] | null

      מערך יעדים לעצירת הסריקה שדה אופציונלי אם יצוין, התגובה תכיל תוצאות SERP עד ערך ההתאמה שצוין, כולל אותו; אפשר לציין עד 10 ערכי יעד במערך הזה דוגמה: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] מידע נוסף על הפרמטר הזה במרכז העזרה - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api חשבונכם יחויב עבור כל SERP שנסרק דרך היעדים שצוינו

      • match_type
        סוג: string | null

        סוג התאמת היעד שדה חובה אם מצוין stop_crawl_on_match; סוג ההתאמה עבור match_value ערכים אפשריים: domain, with_subdomains, wildcard

      • match_value
        סוג: string | null

        דומיין יעד או ערך תו כללי שדה חובה אם מצוין stop_crawl_on_match; ציינו דומיין יעד או ערך תו כללי; הערה: יש לציין את שם הדומיין בלי פרוטוקול בקשה; דוגמה: dataforseo.com

    • tag
      סוג: string | null

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

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

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

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

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

    • target_search_mode
      סוג: string | null

      מצב התאמת יעדים

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

      כדי להפעיל את הפרמטר הזה, יש להפעיל גם את stop_crawl_on_match

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

      ערכים אפשריים: all, any

      all – הסריקה נעצרת רק כשכל היעדים שצוינו נמצאו

      any – הסריקה נעצרת כשנמצא יעד אחד כלשהו

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

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

    • url
      סוג: string | null

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

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

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

      דוגמה:

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


      הערה: פרמטרי מנוע החיפוש הבאים אינם נתמכים ויבוטלו אוטומטית אם יצוינו בכתובת ה-URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskPostResponseInfo
    • cost
      סוג: number | null פורמט: double

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskPostTaskInfo
        • 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
Request Example for post/v1/beta/dataforseo/serp/google/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  },
  {
    "language_name": "English",
    "location_name": "United States",
    "keyword": "albert einstein",
    "priority": 2,
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  },
  {
    "url": "https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
    "postback_data": "html",
    "postback_url": "https://your-server.com/postbackscript"
  }
]'

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

פעולה מוצלחת

Setting Google Organic SERP Tasks