DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Local Finder SERP HTML בזמן אמת
מחזיר את התוצאות המקומיות המורחבות ש-Google מציג כששאילתה היא בבירור מקומית ב-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ערך מרבי:
100
החשבון שלכם יחויב עבור כל SERP המכיל עד 10 תוצאות;הגדרת עומק מעל 10 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-10 תוצאות;
אם העומק שצוין גבוה ממספר התוצאות בתגובה, ההפרש יוחזר אוטומטית ליתרת החשבון שלכם
את העלות אפשר לחשב בעמוד התמחור.
- deviceסוג: string | null
סוג מכשיר
שדה אופציונלי
החזרת תוצאות עבור סוג מכשיר מסוים
יכול לקבל את הערכים:
desktop,mobileערך ברירת מחדל:
desktop - keywordסוג: string
מילת מפתח
שדה חובה
אפשר לציין עד 700 תווים בשדה
keywordכל %## יפענחו (התו ‘+’ יפענח לרווח)
אם אתם צריכים להשתמש בתו “%” ב-
keyword, ציינו אותו כ-“%25”;אם אתם צריכים להשתמש בתו “+” ב-
keyword, ציינו אותו כ-“%2B” - languageסוג: string
_code קוד שפת מנוע החיפוש
שדה חובה אם לא מציינים
language_nameאם משתמשים בשדה הזה, אין צורך לציין
language_nameאפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם
language_codeשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesדוגמה:
en - languageסוג: string
_name השם המלא של שפת מנוע החיפוש
שדה חובה אם לא מציינים
language_codeאם משתמשים בשדה הזה, אין צורך לציין
language_codeאפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם
language_nameשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesדוגמה:
English - locationסוג: integer
_code קוד מיקום מנוע החיפוש
שדה חובה אם לא מציינים
location_nameאוlocation_coordinateאם משתמשים בשדה הזה, אין צורך לציין
location_nameאוlocation_coordinateאפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם
location_codeשלהם על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsדוגמה:
2840 - locationסוג: string
_coordinate קואורדינטות 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סוג: string
_name השם המלא של מיקום מנוע החיפוש
שדה חובה אם לא מציינים
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סוג: string | null
_rating סינון תוצאות לפי דירוג מינימלי
שדה אופציונלי
ערכים אפשריים עבור
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 - tagסוג: string | null
מזהה משימה שהמשתמש מגדיר
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
תמצאו את ערך
tagשצוין באובייקטdataשל התגובה - timeסוג: string | null
_filter סינון תוצאות לפי שעות פתיחה
שדה אופציונלי
בשדה הזה אפשר לסנן מקומות בתוצאות לפי השעות שבהן המקום פתוח למבקרים
שימו לב ש-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"
- סוג: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlTaskInfo
- 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/local_finder/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
}
]
}
]
}
]
}