DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Organic SERP HTML — חי
מחזיר את התוצאות המדורגות עבור מילת מפתח ב-Google, באופן סינכרוני. מקור הדף הגולמי ולא תוצאות מפוענחות. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- depthסוג: integer | null
עומק פענוח
שדה אופציונלי
מספר התוצאות ב-SERP
ערך ברירת מחדל:
10הערך המרבי:
200
החשבון שלכם יחויב עבור כל SERP המכיל עד 10 תוצאות;הגדרת עומק גבוה מ-10 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-10 תוצאות;
אפשר לחשב את העלות בעמוד התמחור.
- deviceסוג: string | null
סוג מכשיר
שדה אופציונלי
החזרת תוצאות עבור סוג מכשיר מסוים
יכול לקבל את הערכים:
desktop,mobileערך ברירת מחדל:
desktop - expandסוג: boolean | null
_ai _overview הרחבת סקירת AI
שדה אופציונלי
הגדירו ל-
trueכדי להרחיב את הפריטai_overview;ערך ברירת מחדל:
false - findסוג: array string[] | null
_targets _in סוגי רכיבי 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"]מידע נוסף על הפרמטר הזה במרכז העזרה שלנו
- ignoreסוג: array string[] | null
_targets _in סוגי רכיבי 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:', 'related:', 'site:', החיוב לכל משימה יוכפל פי 5
- languageסוג: string
_code קוד שפת מנוע החיפוש
שדה חובה אם לא מציינים
language_nameאם משתמשים בשדה הזה, אין צורך לציין
language_nameאפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם
language_codeשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/google/languagesדוגמה:
en - languageסוג: string
_name השם המלא של שפת מנוע החיפוש
שדה חובה אם לא מציינים
language_codeאם משתמשים בשדה הזה, אין צורך לציין
language_codeאפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם
language_nameשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/google/languagesדוגמה:
English - loadסוג: boolean | null
_async _ai _overview טעינת סקירת AI באופן אסינכרוני
שדה אופציונלי
הגדירו ל-
trueכדי לקבל פריטיai_overviewב-SERP גם אם הם נטענים באופן אסינכרוני;אם הערך הוא
false, תקבלו פריטיai_overviewרק מהמטמון;ערך ברירת מחדל:
falseהערה החשבון שלכם יחויב בתוספת של 0.002 דולר עבור כל בקשה;
אם הרכיב חסר או מכיל
"asynchronous_ai_overview": false, כל החיובים הנוספים יוחזרו ליתרת החשבון שלכם - locationסוג: integer
_code קוד מיקום של מנוע החיפוש
שדה חובה אם לא מציינים
location_nameאוlocation_coordinateאם משתמשים בשדה הזה, אין צורך לציין
location_nameאוlocation_coordinateאפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם
location_codeשלהם על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/google/locationsדוגמה:
2840 - locationסוג: string
_coordinate קואורדינטות 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סוג: string
_name השם המלא של מיקום מנוע החיפוש
שדה חובה אם לא מציינים
location_codeאוlocation_coordinateאם משתמשים בשדה הזה, אין צורך לציין
location_codeאוlocation_coordinateאפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם
location_nameשלהם על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/google/locationsדוגמה:
London,England,United Kingdom - matchסוג: string
_type סוג התאמת היעד
שדה חובה אם צוין
stop_crawl_on_matchסוג ההתאמה עבור
match_valueערכים אפשריים:
domain– דומיין או תת-דומיין מסויםwith_subdomains– הדומיין הראשי ותת-הדומייניםwildcard– תבנית תו כללי - matchסוג: string
_value ערך יעד של דומיין, תת-דומיין או תו כללי
שדה חובה אם צוין
stop_crawl_on_matchציינו דומיין, תת-דומיין או ערך תו כללי של יעד;
הערה: יש לציין דומיין או תת-דומיין בלי פרוטוקול בקשה;
דוגמה:
"match_value": "dataforseo.com","match_value": "/blog/post-*" - maxסוג: integer | null
_crawl _pages מגבלת סריקת עמודים
שדה אופציונלי
מספר עמודי תוצאות החיפוש לסריקה
הערך המרבי:
100הערה: תחויבו עבור כל עמוד שייסרק (10 תוצאות אורגניות לעמוד);
מידע נוסף על התמחור בעמוד התמחור;
הערה#2: הפרמטרים
max_crawl_pagesו-depthמשלימים זה את זה;מידע נוסף במרכז העזרה שלנו
- osסוג: string | null
מערכת ההפעלה של המכשיר
שדה אופציונלי
אם תציינו
desktopבשדהdevice, בחרו מבין הערכים הבאים:windows,macosערך ברירת מחדל:
windowsאם תציינו
mobileבשדהdevice, בחרו מבין הערכים הבאים:android,iosערך ברירת מחדל:
android - seסוג: string | null
_domain דומיין מנוע החיפוש
שדה אופציונלי
אנחנו בוחרים את דומיין מנוע החיפוש הרלוונטי באופן אוטומטי לפי המיקום והשפה שתציינו
עם זאת, אפשר להגדיר בשדה הזה דומיין מנוע חיפוש מותאם
דוגמה:
google.co.uk,google.com.au,google.deוכו'. - searchסוג: string | null
_param פרמטרים נוספים של שאילתת החיפוש
שדה אופציונלי
קבלו את רשימת הפרמטרים הזמינים ופרטים נוספים כאן
הערה: פרמטרי מנוע החיפוש הבאים אינם נתמכים ויבוטלו אוטומטית אם יצוינו:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype. - stopסוג: array (object | null)[] | null
_crawl _on _match מערך יעדים לעצירת הסריקה שדה אופציונלי אם יצוין, התגובה תכיל תוצאות 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סוג: string | null
_type סוג התאמת היעד שדה חובה אם מצוין stop_crawl_on_match; סוג ההתאמה עבור match_value ערכים אפשריים: domain, with_subdomains, wildcard
- matchסוג: string | null
_value דומיין יעד או ערך תו כללי שדה חובה אם מצוין stop_crawl_on_match; ציינו דומיין יעד או ערך תו כללי; הערה: יש לציין את שם הדומיין בלי פרוטוקול בקשה; דוגמה: dataforseo.com
- tagסוג: string | null
מזהה משימה שהמשתמש מגדיר
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
תמצאו את ערך
tagשצוין באובייקטdataשל התגובה - targetסוג: string | null
_search _mode מצב התאמת יעדים
שדה אופציונלי
כדי להפעיל את הפרמטר הזה, יש להפעיל גם את
stop_crawl_on_matchמגדיר כיצד הסריקה תיעצר כאשר מצוינים כמה יעדים ב-
stop_crawl_on_matchערכים אפשריים:
all,anyall– הסריקה נעצרת רק כשכל היעדים שצוינו נמצאו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.
- סוג: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- 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סוג: integer | null פורמט: int64
_count מספר התוצאות שמוחזרו במערך
items - keywordסוג: string | null
מילת מפתח שהתקבלה במערך POST
מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח) - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- seסוג: string | null
_domain דומיין מנוע החיפוש במערך POST
- typeסוג: string | null
סוג הרכיב
- resultסוג: integer | null פורמט: int64
_count מספר הפריטים במערך result
- statusסוג: integer | null
_code קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- statusסוג: string | null
_message הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- timeסוג: string | null
זמן ביצוע, בשניות
- סוג: integer | null פורמט: int64tasks
_count מספר המשימות במערך tasks
- סוג: integer | null פורמט: int64tasks
_error מספר המשימות במערך tasks שהוחזרו עם שגיאה
- סוג: string | nulltime
זמן ביצוע כולל, בשניות
- סוג: string | nullversion
הגרסה הנוכחית של ה-API
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/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
}
]
}
]
}
]
}