DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
משימות חיפוש רישומי עסקים בזמן אמת
מחפש באינדקס של DataForSEO עצמו של רישומי עסקים מקומיים לפי categories, description, title ו-location_coordinate — שלשה של קו רוחב, קו אורך ורדיוס. מחזיר total_count, count, offset, offset_token ו-items, עם דפדוף לפי הטוקן. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. זו קוראת אינדקס ועונה מיד; כל השאר כאן מכניס לגירוד חי של המקור. התחילו בזה והתעמקו רק היכן שזה משנה.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.2428 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- categoriesסוג: array string[] | null
קטגוריות עסקיות
שדה אופציונלי
הקטגוריות שמציינים משמשות לחיפוש רישומי עסקים;
אם לא משתמשים בשדה הזה, נחזיר רישומי עסקים שנמצאו במיקום שצוין;
אפשר לציין עד 10 קטגוריות - descriptionסוג: string | null
תיאור הפריט בתוצאות החיפוש
שדה אופציונלי
התיאור של הישות העסקית שעבורה נאספים התוצאות;
יכול להכיל עד 200 תווים - filtersסוג: array (object | null)[] | null
מערך פרמטרים לסינון תוצאות
שדה אופציונלי
אפשר להוסיף כמה מסננים בבת אחת (עד 8)
יש להגדיר אופרטור לוגיandאוorבין התנאים
האופרטורים הנתמכים:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
אפשר להשתמש באופרטור%עםlikeו-not_likeכדי להתאים כל מחרוזת של אפס תווים או יותר
דוגמה:["rating.value",">",3]
אפשר לקבל את רשימת המסננים הזמינים בבקשה נפרדת אלhttps://api.dataforseo.com/v3/business_data/business_listings/available_filters
הרשימה המלאה של המסננים האפשריים זמינה כאן.אובייקט ריק - isסוג: boolean | null
_claimed מציין אם העסק אומת על ידי הבעלים שלו ב-Google Maps
שדה אופציונלי - limitסוג: integer | null
המספר המרבי של עסקים מוחזרים
שדה אופציונלי
ערך ברירת מחדל:100
הערך המרבי:1000 - locationסוג: string | null
_coordinate קואורדינטות GPS של מיקום
שדה אופציונלי
את הפרמטרlocation_coordinateיש לציין בפורמט "latitude,longitude,radius"
המספר המרבי של ספרות עשרוניות ב-"latitude" וב-"longitude": 7
הערך של "radius" מצוין בקילומטרים (km)
הערך המזערי של "radius":1
הערך המרבי של "radius":100000
דוגמה:53.476225,-2.243572,200
מידע נוסף על קביעת פרמטרי מיקום ב-API הזה זמין במרכז העזרה - offsetסוג: integer | null
היסט במערך התוצאות של העסקים המוחזרים
שדה אופציונלי
ערך ברירת מחדל:0
אם מציינים את הערך10, עשר הישויות הראשונות במערך התוצאות יושמטו והנתונים יסופקו עבור הישויות העוקבות
הערה: מומלץ להשתמש בפרמטר זה רק כשמאחזרים עד 10,000 תוצאות
לאחזור יותר מ-10,000 תוצאות, השתמשו ב-offset_tokenבמקום - offsetסוג: string | null
_token טוקן היסט לבקשות עוקבות
שדה אופציונלי
מסופק בשדה הזהה בתגובה לכל בקשה;
השתמשו בפרמטר הזה כדי להימנע מפסקי זמן כשמנסים לקבל יותר מ-100,000 תוצאות בבקשה אחת;
אם תציינו את ערךoffset_tokenהייחודי ממערך התגובה, תקבלו את התוצאות העוקבות של המשימה הראשונית;
ערכיoffset_tokenייחודיים לכל משימה עוקבת
הערה: אם מצויןoffset_tokenבבקשה, כל שאר הפרמטרים צריכים להיות זהים לבקשה הקודמת
מידע נוסף על הפרמטר הזה זמין במרכז העזרה שלנו - orderסוג: array string[] | null
_by כללי מיון תוצאות
שדה אופציונלי
אפשר להשתמש באותם ערכים כמו במערךfiltersכדי למיין את התוצאות
סוגי מיון אפשריים:asc— התוצאות ימוינו בסדר עולהdesc— התוצאות ימוינו בסדר יורד
יש להשתמש בפסיק כדי להגדיר פרמטר מיון
דוגמה:["rating.value,desc"]שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
יש להפריד בין כמה כללי מיון בפסיק
דוגמה:["rating.value,desc","rating.votes_count,desc"] - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה - titleסוג: string | null
כותרת הפריט בתוצאות החיפוש
שדה אופציונלי
השם של הישות העסקית שעבורה נאספים התוצאות;
יכול להכיל עד 200 תווים
- סוג: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
- 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
מערך תוצאות
- countסוג: integer | null פורמט: int64
סוגי פריטים
מספר הפריטים במערךitems - itemsסוג: array (object | null)[] | null
סוגי פריטים שנמצאו
סוגי תוצאות מנוע החיפוש שנמצאו במערךitems;
סוגי פריטים אפשריים:business_listing- additionalסוג: array (string | null)[] | null
_categories קטגוריות עסקיות נוספות
קטגוריות נוספות ב-Google My Business שמתארות בפירוט רב יותר את השירותים שההישות העסקית מספקת - addressסוג: string | null
הכתובת של הישות העסקית
- addressסוג: object | null · Response36Afe1097B20_AddressInfo
_info אובייקט המכיל את רכיבי הכתובת של הישות העסקית
- addressסוג: string | null
כתובת הרחוב של העסק המקומי
- boroughסוג: string | null
היחידה המינהלית או המחוז שאליהם שייך העסק המקומי
- cityסוג: string | null
שם העיר שבה נמצא העסק המקומי
- countryסוג: string | null
_code קוד מדינה ISO של העסק המקומי
- regionסוג: string | null
אזור DMA שאליו שייך העסק המקומי
- zipסוג: string | null
מיקוד של העסק המקומי
- attributesסוג: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
פרטי השירות בצורת בדיקות שנסקרו על ידי משתמשים;
פרטי השירות של ישות עסקית המוצגים בצורת בדיקות ומבוססים על משוב משתמשים ועל ה-categoryשל העסק- availableסוג: object | null
_attributes מאפיינים זמינים
מציין מאפיינים שישות עסקית יכולה להציע- propertyסוג: array (string | null)[] | null
Name
- unavailableסוג: object | null
_attributes מאפיינים לא זמינים
מציין מאפיינים שישות עסקית אינה יכולה להציע- propertyסוג: array (string | null)[] | null
Name
- categoryסוג: string | null
קטגוריית עסקים
הקטגוריה הכללית ב-Google My Business שמתארת בצורה הטובה ביותר את השירותים שההישות העסקית מספקת - categoryסוג: array (string | null)[] | null
_ids מזהי קטגוריה גלובליים
מזהי קטגוריה אוניברסליים שאינם משתנים בהתאם למדינה שנבחרה - checkסוג: string | null
_url כתובת URL ישירה לתוצאות מנוע החיפוש
אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות - cidסוג: string | null
- contactסוג: array (object | null)[] | null
_info אנשי קשר זמינים של העסק
רשימת אנשי קשר ליצירת קשר עם העסק- sourceסוג: string | null
מקור הנתונים
- typeסוג: string | null
סוג הרכיב
- valueסוג: string | null
ערך הדירוג
- descriptionסוג: string | null
תיאור הרכיב ב-SERP
התיאור של הישות העסקית שעבורה נאספות התוצאות - domainסוג: string | null
הדומיין של הישות העסקית
- featureסוג: string | null
_id - firstסוג: string | null
_seen תאריך ושעה שבהם הסורק שלנו מצא לראשונה את רכיב רישום העסק
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2023-03-11 10:04:11 +00:00 - hotelסוג: integer | null
_rating - isסוג: boolean | null
_claimed מראה אם הישות מאומתת על ידי הבעלים שלה ב-Google Maps
- lastסוג: string | null
_updated _time תאריך ושעה שבהם הנתונים עודכנו לאחרונה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2023-01-26 09:03:15 +00:00 - latitudeסוג: number | null
קואורדינטת הרוחב של העסקים המקומיים ב-google maps
דוגמה:"latitude": 51.584091 - localסוג: array (object | null)[] | null
_business _links אינטראקציות זמינות עם העסק
רשימת אפשרויות ליצירת אינטראקציה עם העסק ישירות מתוצאות החיפוש- typeסוג: string | null
סוג הרכיב
- logoסוג: string | null
כתובת URL של הלוגו המוצג בפרופיל Google My Business
- longitudeסוג: number | null
קואורדינטת האורך של העסק המקומי ב-google maps
דוגמה:"longitude": -0.31365919999999997 - mainסוג: string | null
_image כתובת ה-URL של התמונה הראשית שמופיעה בפרופיל Google My Business
- originalסוג: string | null
_title הכותרת המקורית של הרכיב
הכותרת המקורית שלא תורגמה על ידי Google - peopleסוג: array (object | null)[] | null
_also _search ישויות עסקיות קשורות
- cidסוג: string | null
- featureסוג: string | null
_id - ratingסוג: object | null · Response36Afe1097B20_RatingInfo
הדירוג של הרכיב
שיעור הפופולריות בהתבסס על ביקורות ומוצג ב-SERP- ratingסוג: integer | null
_max הערך המקסימלי של rating_type
- ratingסוג: string | null
_type סוג הדירוג כאן אפשר למצוא את הרכיבים הבאים: Max5, Percents, CustomMax
- valueסוג: number | null פורמט: double
ערך הדירוג
- votesסוג: integer | null פורמט: int64
_count כמות המשוב
- titleסוג: string | null
כותרת הרכיב ב-SERP
שם הישות העסקית שעבורה נאספות התוצאות
- phoneסוג: string | null
מספר הטלפון של הישות העסקית
- placeסוג: string | null
_id מזהה מקום ייחודי
מזהה מקום של העסק המקומי המוצג ברכיב
מידע נוסף על המזהה במאמר מרכז העזרה הזה - placeסוג: object | null
_topics מילות מפתח המוזכרות בביקורות של לקוחות
מכיל את מילות המפתח הפופולריות ביותר הקשורות למוצרים/שירותים המוזכרים בביקורות של לקוחות של ישות עסקית, ואת מספר הביקורות שמזכירות כל מילת מפתח
דוגמה:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyסוג: integer | null פורמט: int64
Name Signed 64-bit integers (long type).
- popularסוג: object | null · Response36Afe1097B20_PopularTimes
_times זמנים פופולריים
מידע על שעות העומס של הישות העסקית- popularסוג: object | null
_times _by _days שעות פופולריות
מידע על שעות העומס של העסק המקומי בכל יום בשבוע- propertyסוג: array (object | null)[] | null
Name שעות פעילות בימי ראשון
- popularסוג: integer | null
_index מדד פופולריות מדד פופולריות יחסי וזמן-תלוי, בסולם 0 עד 100; ערך גבוה יותר מתאים לשעה עמוסה יותר ביום
- timeסוג: object | null · Response36Afe1097B20_TimeInfo
שעות בפורמט 24 שעות
- hourסוג: integer | null
שעות בפורמט 24 שעות
- minuteסוג: integer | null
דקות
- priceסוג: string | null
_level רמת המחיר של העסק
יכול לקבל את הערכים:inexpensive,moderate,expensive,very_expensive
אם אין מידע על רמת המחיר, הערך יהיהnull - ratingסוג: object | null · Response36Afe1097B20_RatingInfo
הדירוג של הרכיב
שיעור הפופולריות בהתבסס על ביקורות ומוצג ב-SERP- ratingסוג: number | null פורמט: double
_max הערך המקסימלי של rating_type
- ratingסוג: string | null
_type סוג הדירוג כאן אפשר למצוא את הרכיבים הבאים: Max5, Percents, CustomMax
- valueסוג: number | null פורמט: double
ערך הדירוג
- votesסוג: integer | null פורמט: int64
_count כמות המשוב
- ratingסוג: object | null
_distribution התפלגות הדירוגים של הישות העסקית
האובייקט מציג את מספר הדירוגים מ-1 כוכבים עד 5 כוכבים, כפי שנסקרו על ידי משתמשים- propertyסוג: integer | null פורמט: Int64
Name
- servicesסוג: array (object | null)[] | null
- categoryסוג: string | null
קטגוריית עסקים
הקטגוריה הכללית ב-Google My Business שמתארת בצורה הטובה ביותר את השירותים שההישות העסקית מספקת - priceסוג: object | null · Response36Afe1097B20_PriceInfo
- currencyסוג: string | null
המטבע של המחיר המוצג קוד ISO של המטבע החל על המחיר
- currentסוג: number | null פורמט: double
מחיר נוכחי מציין את המחיר הנוכחי של המוצר או השירות שמופיע בתוצאה
- displayedסוג: string | null
_price מחרוזת המחיר בתוצאה מחרוזת המחיר הגולמית כפי שהיא מסופקת בתוצאה
- isסוג: boolean | null
_price _range המחיר מסופק כטווח מציין אם המחיר מסופק כטווח
- maxסוג: number | null פורמט: double
_value המחיר המקסימלי המחיר המקסימלי של המוצר או השירות כפי שמצוין בתוצאה
- regularסוג: number | null פורמט: double
מחיר רגיל מציין את המחיר הרגיל של המוצר או השירות ללא הנחות
- snippetסוג: string | null
מידע נוסף על הישות העסקית
- titleסוג: string | null
כותרת הרכיב ב-SERP
שם הישות העסקית שעבורה נאספות התוצאות
- snippetסוג: string | null
מידע נוסף על הישות העסקית
- titleסוג: string | null
כותרת הרכיב ב-SERP
שם הישות העסקית שעבורה נאספות התוצאות - totalסוג: integer | null פורמט: int64
_photos הספירה הכוללת של תמונות שמופיעות בפרופיל Google My Business
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת URL מוחלטת של הישות העסקית
- workסוג: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time פרטי שעות הפעילות
מידע על שעות הפעילות של הישות העסקית- workסוג: object | null · Response36Afe1097B20_WorkHours
_hours שעות פתיחה
מידע על שעות העבודה של העסק המקומי- currentסוג: string | null
_status הסטטוס הנוכחי של המוסד
מציין אם המוסד פתוח או סגור - timetableסוג: object | null
לוח שעות הפעילות
- propertyסוג: array (object | null)[] | null
Name שעות פעילות בימי ראשון
- closeסוג: object | null · Response36Afe1097B20_TimeInfo
שעת סגירה
- hourסוג: integer | null
שעות בפורמט 24 שעות
- minuteסוג: integer | null
דקות
- openסוג: object | null · Response36Afe1097B20_TimeInfo
שעת פתיחה
- hourסוג: integer | null
שעות בפורמט 24 שעות
- minuteסוג: integer | null
דקות
- offsetסוג: integer | null פורמט: int64
Signed 64-bit integers (long type).
- offsetסוג: string | null
_token - totalסוג: integer | null פורמט: int64
_count המספר הכולל של תוצאות במסד הנתונים שלנו הרלוונטיות לבקשה שלכם
- 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/business_data/business_listings/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"categories": [
"pizza_restaurant"
],
"description": "פיצה",
"title": "pizza",
"is_claimed": true,
"location_coordinate": "53.476225,-2.243572,10",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 3
}
]'
{
"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": [
{
"total_count": null,
"count": null,
"offset": null,
"offset_token": null,
"items": [
{
"type": null,
"title": null,
"original_title": null,
"description": null,
"category": null,
"category_ids": [
"[Max Depth Exceeded]"
],
"additional_categories": [
"[Max Depth Exceeded]"
],
"cid": null,
"feature_id": null,
"address": null,
"address_info": "[Max Depth Exceeded]",
"place_id": null,
"phone": null,
"url": null,
"domain": null,
"logo": null,
"main_image": null,
"total_photos": null,
"snippet": null,
"latitude": null,
"longitude": null,
"is_claimed": null,
"attributes": "[Max Depth Exceeded]",
"place_topics": null,
"rating": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"rating_type": "[Max Depth Exceeded]",
"value": "[Max Depth Exceeded]",
"votes_count": "[Max Depth Exceeded]",
"rating_max": "[Max Depth Exceeded]"
},
"hotel_rating": null,
"price_level": null,
"rating_distribution": null,
"people_also_search": [
"[Max Depth Exceeded]"
],
"work_time": "[Max Depth Exceeded]",
"popular_times": "[Max Depth Exceeded]",
"local_business_links": [
"[Max Depth Exceeded]"
],
"contact_info": [
"[Max Depth Exceeded]"
],
"check_url": null,
"last_updated_time": null,
"first_seen": null,
"services": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}