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 توزيع تقييمات الكيان التجاري
يعرض الكائن عدد التقييمات من نجمة واحدة إلى 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]"
]
}
]
}
]
}
]
}