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

إعداد مهام Naver 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 العمليات

إعداد مهام Naver Organic SERP

​

يضع النتائج المرتّبة لكلمة مفتاحية على Naver في قائمة الانتظار، ويعيد id للمهمة في tasks[0].id. الاستجابة مغلّفة في غلاف 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
      القيمة الافتراضية: 15
      الحد الأقصى: 700
      ستُحتسب على حسابك رسوم عن كل SERP يحتوي على ما يصل إلى 15 نتيجة؛
      قد يؤدي تعيين عمق أعلى من 15 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 15 نتيجة؛
      يمكن حساب التكلفة في صفحة الأسعار.

    • device
      النوع: string | null

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

    • keyword
      النوع: string

      الكلمة المفتاحية
      حقل مطلوب
      يمكنك تحديد حتى 700 حرف في الحقل keyword
      سيُفك ترميز كل %## (وسيُفك ترميز الحرف «+» إلى مسافة)
      إذا كنت بحاجة إلى استخدام الحرف «%» في keyword، فحدده بالشكل «%25»؛
      إذا كنت بحاجة إلى استخدام الحرف «+» في keyword، فحدده بالشكل «%2B»

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

    • max_crawl_pages
      النوع: integer | null

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

    • os
      النوع: string | null

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

    • pingback_url
      النوع: string | null

      عنوان URL لإشعار اكتمال المهمة
      حقل اختياري
      عند اكتمال المهمة، سنُشعرك عبر طلب GET يُرسل إلى عنوان URL الذي حددته
      يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب.
      مثال:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      ملاحظة: تُرمَّز الأحرف الخاصة في pingback_url بترميز urlencoded;
      منها أن الحرف # يُرمَّز إلى %23

      تعرّف على المزيد في مركز المساعدة

    • postback_data
      النوع: string

      نوع بيانات postback_url
      حقل مطلوب إذا حددت postback_url
      يتوافق مع الدالة التي استخدمتها لتعيين المهمة
      القيم الممكنة:
      regular، advanced، html

    • postback_url
      النوع: string | null

      عنوان URL لإرسال نتائج المهمة
      حقل اختياري
      بعد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بصيغة gzip إلى postback_url الذي حددته
      يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب.
      مثال:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      ملاحظة: تُرمَّز الأحرف الخاصة في postback_url بترميز urlencoded;
      منها أن الحرف # يُرمَّز إلى %23

      تعرّف على المزيد في مركز المساعدة

    • priority
      النوع: integer | null

      أولوية المهمة
      حقل اختياري
      يمكن أن تأخذ القيم التالية:
      1 – أولوية تنفيذ عادية (تُضبط افتراضيًا)
      2 – أولوية تنفيذ عالية. ستُحتسب عليك رسوم إضافية للمهام ذات أولوية التنفيذ العالية.
      يمكن حساب التكلفة في صفحة الأسعار.

    • se_domain
      النوع: string | null

      نطاق محرك البحث
      حقل اختياري
      نختار نطاق محرك البحث المناسب تلقائيًا
      ومع ذلك، يمكنك تعيين نطاق محرك بحث مخصص في هذا الحقل
      مثال:
      search.naver.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 ضمن الاستجابة

    • url
      النوع: string | null

      عنوان URL المباشر لاستعلام البحث
      حقل اختياري
      يمكنك تحديد عنوان URL مباشر وسنقوم بتحليله إلى الحقول اللازمة
      في معظم الحالات، لا نوصي باستخدام هذه الطريقة؛
      مثال:
      https://search.naver.com/search.naver?where=nexearch&sm=top_hty&fbm=1&ie=utf8&query=iphone

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

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

        • data
          النوع: object | null

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

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

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

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

          مسار URL

        • result
          النوع: object | null

          مصفوفة نتائج
          في هذه الحالة، ستكون القيمة 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/naver/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/naver/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "albert einstein",
    "device": "desktop",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "regular"
  }
]'

{
  "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": null
    }
  ]
}

عملية ناجحة

Setting Naver Organic SERP Tasks