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

Yahoo Organic SERP العادي المباشر

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO العمليات

Yahoo Organic SERP العادي المباشر

​

يعيد النتائج المرتّبة لكلمة مفتاحية على Yahoo بشكل متزامن. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. الاستجابة مغلّفة في غلاف 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
      القيمة الافتراضية: 6
      الحد الأقصى: 200
      ستُحتسب على حسابك رسوم عن كل SERP؛
      قد تحتوي كل صفحة SERP من Yahoo على أقل من 10 نتائج، لذا قد يؤدي تعيين عمق أعلى من القيمة الافتراضية إلى رسوم إضافية ؛
      يمكن حساب التكلفة في صفحة الأسعار.

    • device
      النوع: string | null

      نوع الجهاز
      حقل اختياري
      يمكن أن تأخذ القيم:desktop، mobile
      القيمة الافتراضية: desktop

    • keyword
      النوع: string

      الكلمة المفتاحية
      حقل مطلوب
      يمكنك تحديد حتى 700 حرف في حقل keyword
      سيُفكّ ترميز جميع %## (وسيُفكّ ترميز المحرف '+' إلى مسافة)
      إذا كنت تحتاج إلى استخدام المحرف "%" في keyword، فحدده كـ"%25"؛
      إذا كنت تحتاج إلى استخدام المحرف “+” في keyword، فحدده كـ“%2B”

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

    • language_code
      النوع: string

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

    • 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,radius"
      الحد الأقصى لعدد الخانات العشرية لـ "latitude" و"longitude": 7
      الحد الأدنى لقيمة "radius": 199.9 (مم)
      الحد الأقصى لقيمة "radius": 199999 (مم)
      مثال:
      53.476225,-2.243572,200

    • 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

    • max_crawl_pages
      النوع: integer | null

      حد زحف الصفحات
      حقل اختياري
      عدد صفحات نتائج البحث المراد زحفها
      القيمة الافتراضية: 1
      الحد الأقصى: 100
      ملاحظة: المعاملان max_crawl_pages وdepth يكمّل أحدهما الآخر؛
      تعرّف على المزيد في مركز المساعدة

    • os
      النوع: string | null

      نظام تشغيل الجهاز
      حقل اختياري
      إذا حددت desktop في حقل device، فاختر من القيم التالية: windows، macos
      القيمة الافتراضية: windows
      إذا حددت mobile في حقل device، فاختر من القيم التالية: android، ios
      القيمة الافتراضية: android

    • se_domain
      النوع: string | null

      نطاق محرك البحث
      حقل اختياري
      نختار نطاق محرك البحث المناسب تلقائيًا وفقًا للموقع واللغة التي تحددها
      ومع ذلك، يمكنك تعيين نطاق محرك بحث مخصص في هذا الحقل
      مثال:
      au.search.yahoo.com، uk.search.yahoo.com، ca.search.yahoo.com، إلخ.

    • search_param
      النوع: string | null

      معاملات إضافية لاستعلام البحث
      حقل اختياري
      احصل على قائمة المعاملات المتاحة والتفاصيل الإضافية هنا

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

      مصفوفة أهداف لإيقاف الزحف حقل اختياري إذا حُددت، ستحتوي الاستجابة على نتائج 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_type
        النوع: string | null

        نوع مطابقة الهدف حقل مطلوب إذا حُدد stop_crawl_on_match؛ نوع المطابقة لقيمة match_value القيم الممكنة: domain، with_subdomains، wildcard

      • match_value
        النوع: string | null

        النطاق الهدف أو قيمة wildcard حقل مطلوب إذا حُدد stop_crawl_on_match؛ حدد نطاقًا هدفًا أو قيمة wildcard؛ ملاحظة: يجب تحديد اسم النطاق دون بروتوكول طلب؛ مثال: dataforseo.com

    • tag
      النوع: string | null

      معرّف مهمة يحدده المستخدم
      حقل اختياري
      الحد الأقصى للأحرف هو 255
      يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
      ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

    • target
      النوع: string | null

      النطاق أو النطاق الفرعي أو صفحة الويب المستهدفة للحصول على نتائج لها
      حقل اختياري
      يجب تحديد النطاق أو النطاق الفرعي دون https:// وwww.
      لاحظ أن نتائج المهام الخاصة بـtarget لن تتضمن إلا عناصر SERP التي تحتوي على سلسلة url؛
      يمكنك أيضًا استخدام حرف بدل (‘’) لتحديد نمط البحث في SERP وتضييق النتائج؛
      أمثلة:
      example.com - تعيد نتائج للصفحة الرئيسية للموقع بعناوين URL مثل https://example.com أو https://www.example.com/ أو https://example.com/؛
      example.com       - تعيد نتائج للنطاق، بما في ذلك جميع صفحاته؛
      example.com - تعيد نتائج للنطاق بأكمله، بما في ذلك جميع صفحاته ونطاقاته الفرعية؛
      example.com - تعيد نتائج للصفحة الرئيسية بغض النظر عن النطاق الفرعي، مثل https://en.example.com؛
      example.com/example-page - تعيد نتائج لعنوان URL المحدد؛
      example.com/example-page       - تعيد نتائج لجميع عناوين URL للنطاق التي تبدأ بالسلسلة المحددة

    • url
      النوع: string | null

      عنوان URL المباشر لاستعلام البحث
      حقل اختياري
      يمكنك تحديد عنوان URL مباشر وسنقوم بتحليله إلى الحقول اللازمة. لاحظ أن هذه الطريقة هي الأصعب على API لدينا في المعالجة وتتطلب أيضًا تحديد اللغة والموقع بدقة في عنوان URL. في معظم الحالات، لا نوصي باستخدام هذه الطريقة.
      مثال:
      https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_SerpYahooOrganicLiveRegularTaskInfo
        • 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 المُعاد
            أنواع العناصر الممكنة:
            featured_snippet، images، local_pack، hotels_pack، organic، paid، people_also_ask، related_searches، shopping، recipes، top_stories، video، ai_overview؛
            ملاحظة أن هذه المصفوفة تحتوي على جميع أنواع نتائج البحث الموجودة في SERP المُعاد؛
            غير أن نقطة النهاية هذه توفر بيانات لأنواع organic وpaid وfeatured_snippet فقط؛
            للحصول على جميع العناصر (بما فيها ميزات SERP والمقتطفات الغنية) الموجودة في SERP المُعاد، راجع Yahoo Organiс Advanced SERP endpoint

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

            العناصر في SERP

            • page
              النوع: integer | null

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

            • position
              النوع: string | null

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

            • 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 للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل

            • type
              النوع: string | null

              نوع العنصر

            • xpath
              النوع: string | null

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

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

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

          • keyword
            النوع: string | null

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

          • language_code
            النوع: string | null

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

          • location_code
            النوع: integer | null

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

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

            إجمالي الصفحات المستردّة
            العدد الإجمالي لنتائج SERP المستردّة في النتيجة

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

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

            • 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/yahoo/organic/live/regular
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/organic/live/regular \
  --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,
          "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,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Live Yahoo Organic SERP Regular