Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Google Local Finder 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 Local Finder SERP المباشر

​

يعيد بشكل متزامن النتائج المحلية الموسّعة التي يعرضها Google عندما يكون الاستعلام محليًا بوضوح على Google. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. advanced هو الخيار الافتراضي؛ استخدم regular عندما تكون القائمة المرتّبة وحدها هي المهمة، وhtml فقط للتحقق مما أسقطه المحلّل. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.02 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: 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»


      تعرّف على المزيد حول قواعد وقيود الحقلين keyword وkeywords في DataForSEO APIs في مقال مركز المساعدة

    • language_code
      النوع: string

      رمز لغة محرك البحث

      حقل مطلوب إذا لم تحدد language_name

      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name

      يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      مثال:en

    • language_name
      النوع: string

      الاسم الكامل للغة محرك البحث

      حقل مطلوب إذا لم تحدد language_code

      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code

      يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      مثال:

      English

    • location_code
      النوع: integer

      رمز موقع محرك البحث

      حقل مطلوب إذا لم تحدد location_name أو location_coordinate

      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_coordinate

      يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      مثال:

      2840

    • location_coordinate
      النوع: string

      إحداثيات 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_name
      النوع: string

      الاسم الكامل لموقع محرك البحث

      حقل مطلوب إذا لم تحدد 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_rating
      النوع: number | null التنسيق: double

      تصفية النتائج حسب الحد الأدنى للتقييم

      حقل اختياري

      القيم الممكنة لـ 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

    • priority
      النوع: integer | null

      أولوية المهمة

      حقل اختياري

      يمكن أن تأخذ القيم التالية:

      1 – أولوية التنفيذ العادية (تُعيّن افتراضيًا)

      2 – أولوية التنفيذ العالية


      ستُفرض عليك رسوم إضافية على المهام ذات أولوية التنفيذ العالية.

      يمكن حساب التكلفة في صفحة الأسعار.

    • tag
      النوع: string | null

      معرّف مهمة يعرّفه المستخدم

      حقل اختياري

      حد الأحرف 255

      يمكنك استخدام هذا المعامل لتعريف المهمة ومطابقتها مع النتيجة

      ستجد قيمة tag المحددة في كائن data في الاستجابة

    • time_filter
      النوع: string | null

      تصفية النتائج حسب ساعات العمل

      حقل اختياري

      باستخدام هذا الحقل، يمكنك تصفية الأماكن في النتائج حسب الوقت التي تكون فيه مفتوحة للزوار

      لاحظ أن 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"

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

    • tasks
      النوع: array (object | null)[] | null

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedTaskInfo
        • cost
          النوع: number | null التنسيق: double

          إجمالي تكلفة المهام، بالدولار الأمريكي

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

        • path
          النوع: array (string | null)[] | null

          مسار URL

        • result
          النوع: array (object | null)[] | null

          مصفوفة نتائج

          • check_url
            النوع: string | null

            عنوان URL مباشر لنتائج محرك البحث
            يمكنك استخدامه للتأكد من أننا قدّمنا نتائج مطابقة

          • datetime
            النوع: string | null

            التاريخ والوقت اللذان استُلمت فيهما النتيجة
            بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

          • item_types
            النوع: array (string | null)[] | null

            أنواع نتائج البحث في SERP
            تحتوي على أنواع نتائج البحث (items) الموجودة في SERP.
            أنواع العناصر الممكنة:
            local_pack

          • items
            النوع: array (object | null)[] | null

            العناصر داخل العنصر

            • النوع: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • النوع: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    المميّز
                    النوع: string | null

                    نوع العنصر

                  • booking_url
                    النوع: string | null

                    عنوان URL لصفحة الحجز

                  • cid
                    النوع: string | null

                    معرّف العميل المحدد من Google

                  • description
                    النوع: string | null

                    وصف الرابط

                  • domain
                    النوع: string | null

                    نطاق الموقع الإلكتروني الذي يستضيف الفيديو

                  • is_paid
                    النوع: boolean | null

                    تشير إلى ما إذا كان العنصر إعلانًا

                  • page
                    النوع: integer | null

                    رقم صفحة نتائج البحث
                    يشير إلى رقم صفحة SERP التي يقع فيها العنصر

                  • phone
                    النوع: string | null

                    رقم الهاتف

                  • position
                    النوع: string | null

                    محاذاة العنصر في SERP
                    يمكن أن تأخذ القيم التالية:
                    left، right

                  • rank_absolute
                    النوع: integer | null

                    الرتبة المطلقة في SERP
                    الموضع المطلق بين جميع العناصر في SERP
                    يساوي دائمًا 0 في desktop

                  • rank_group
                    النوع: integer | null

                    رتبة المجموعة في SERP
                    الموضع ضمن مجموعة عناصر لها قيم type متطابقة؛
                    تُستبعد مواضع العناصر ذات قيم type المختلفة من rank_group؛
                    يساوي دائمًا 0 في desktop

                  • rating
                    النوع: object | null · Response36Afe1097B20_RatingInfo

                    تقييم العنصر
                    معدل الشعبية استنادًا إلى المراجعات والمعروض في SERP؛
                    إذا لم يكن موجودًا، يساوي null

                    • rating_max
                      النوع: integer | null

                      الحد الأقصى لقيمة rating_type

                    • rating_type
                      النوع: string | null

                      نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax

                    • value
                      النوع: number | null التنسيق: double

                      قيمة التقييم

                    • votes_count
                      النوع: integer | null التنسيق: int64

                      مقدار الملاحظات

                  • rectangle
                    النوع: object | null · Response36Afe1097B20_AiModeRectangleInfo

                    معاملات المستطيل
                    تحتوي على الإحداثيات الديكارتية وأبعاد البكسل لمقتطف النتيجة في SERP
                    تساوي null إذا لم يُضبط calculate_rectangles في طلب POST على true

                    • height
                      النوع: number | null التنسيق: double

                      ارتفاع العنصر بالبكسل

                    • width
                      النوع: number | null التنسيق: double

                      عرض العنصر بالبكسل

                    • x
                      النوع: number | null التنسيق: double

                      إحداثي المحور x إحداثي المحور x للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل

                    • y
                      النوع: number | null التنسيق: double

                      إحداثي المحور y إحداثي المحور y للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل

                  • title
                    النوع: string | null

                    عنوان الصف

                  • url
                    النوع: string | null

                    عنوان URL لمصدر المراجعة الخارجي

                  • xpath
                    النوع: string | null

                    XPath الخاص بالعنصر

          • items_count
            النوع: integer | null التنسيق: int64

            عدد النتائج المعادة في المصفوفة items

          • keyword
            النوع: string | null

            الكلمة المفتاحية المستلمة في مصفوفة POST
            تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز المحرف '+' إلى مسافة)

          • language_code
            النوع: string | null

            رمز اللغة في مصفوفة POST

          • location_code
            النوع: integer | null

            رمز الموقع في مصفوفة POST

          • refinement_chips
            النوع: object | null · Response36Afe1097B20_RefinementChipsInfo

            شرائح تنقية البحث

            • items
              النوع: array (object | null)[] | null

              العناصر التابعة للعنصر

              • domain
                النوع: string | null

                النطاق في SERP

              • options
                النوع: array (object | null)[] | null

                خيارات تحسين البحث الإضافية

                • domain
                  النوع: string | null

                  النطاق في SERP

                • title
                  النوع: string | null

                  عنوان العنصر

                • type
                  النوع: string | null

                  نوع العنصر

                • url
                  النوع: string | null

                  عنوان URL للبحث مع معاملات التنقية

              • title
                النوع: string | null

                عنوان العنصر

              • type
                النوع: string | null

                نوع العنصر

              • url
                النوع: string | null

                عنوان URL للبحث مع معاملات التنقية

            • type
              النوع: string | null

              نوع العنصر

            • xpath
              النوع: string | null

              XPath الخاص بالعنصر

          • se_domain
            النوع: string | null

            نطاق محرك البحث في مصفوفة POST

          • se_results_count
            النوع: integer | null التنسيق: int64

            العدد الإجمالي للنتائج في SERP

          • spell
            النوع: object | null · Response36Afe1097B20_SpellInfo

            التصحيح التلقائي لمحرك البحث
            إذا قدّم محرك البحث نتائج لكلمة مفتاحية صُحّحت، فسنحدد الكلمة المفتاحية التي صحّحها محرك البحث ونوع التصحيح التلقائي

            • keyword
              النوع: string | null

              الكلمة المفتاحية التي تم الحصول عليها نتيجة التصحيح التلقائي لمحرك البحث ستُقدَّم النتائج للكلمة المفتاحية المصححة

            • type
              النوع: string | null

              نوع التصحيح التلقائي القيم الممكنة: did_you_mean, showing_results_for, no_results_found_for, including_results_for ملاحظة: يدعم Yahoo وYandex نوع التصحيح التلقائي التالي فقط: including_results_for

          • type
            النوع: string | 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/local_finder/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "local nail services",
    "min_rating": 4.5,
    "time_filter": "monday"
  }
]'

{
  "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,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Live Google Local Finder SERP