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

إعداد مهام قائمة تطبيقات Apple

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

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام قائمة تطبيقات Apple

​

يضع إحدى مجموعات App Store المنسّقة في قائمة الانتظار، المختارة بـapp_collection، ويعيد معرّف مهمة id. يحدّ depth مدى النزول في التصنيف. غير متزامن: يعيد الإرسال معرّف مهمة id في tasks[0].id، وتعيد أداة الجلب النتيجة فور جاهزيتها. استرجع النتيجة عبر get_dataforseo_app_apple_app_list_fetch. لا يوجد متغير HTML في جانب Apple.

مرجع التسعير

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

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

الجسم
application/json
  • النوع: array (object | null)[]
    • app_category
      النوع: string | null

      فئة التطبيق على App Store. حقل اختياري. يمكنك تصفية النتائج حسب فئة التطبيق؛ مثال: lifestyle؛ يمكنك مراجعة القائمة الكاملة للفئات المتاحة هنا أو عبر طلب منفصل إلى https://api.dataforseo.com/v3/app_data/apple/categories

    • app_collection
      النوع: string

      مجموعة التطبيقات. حقل مطلوب. مجموعة التطبيقات على App Store التي ستُجمع منها التطبيقات؛ يمكنك تحديد القيم التالية: top_free_ios، top_paid_ios، top_grossing_ios، new_ios، new_free_ios، new_paid_ios

    • depth
      النوع: integer | null

      عمق التحليل. حقل اختياري. عدد التطبيقات التي ستُعاد من SERP الخاص بـ App Store؛ القيمة الافتراضية: 100. الحد الأقصى: 100. ستُحتسب رسوم حسابك لكل SERP يحتوي على ما يصل إلى 100 نتيجة؛ يمكن حساب التكلفة في صفحة الأسعار.

    • language_code
      النوع: string | null

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

    • language_name
      النوع: string | null

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

    • location_code
      النوع: integer | null

      رمز موقع محرك البحث. حقل مطلوب إذا لم تحدد location_name. إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد location_name. يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع location_code الخاصة بها عبر طلب منفصل إلى https://api.dataforseo.com/v3/app_data/apple/locations. مثال: 9061121

    • location_name
      النوع: string | null

      الاسم الكامل لموقع محرك البحث. حقل مطلوب إذا لم تحدد location_code. إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد location_code. يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع location_name عبر طلب منفصل إلى https://api.dataforseo.com/v3/app_data/apple/locations. مثال: West Los Angeles,California,United States

    • pingback_url
      النوع: string | null

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

    • postback_data
      النوع: string | null

      نوع بيانات postback_url. حقل مطلوب إذا حددت postback_url. يطابق نوع البيانات الذي سيُرسل إلى خادمك. القيم الممكنة: advanced

    • postback_url
      النوع: string | null

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

    • priority
      النوع: integer | null

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

    • tag
      النوع: string | null

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

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_AppDataAppleAppListTaskPostTaskInfo
        • 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/app_data/apple/app_list/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "top_free_ios",
    "location_code": 2840,
    "language_code": "en",
    "app_category": "games"
  }
]'

{
  "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 Apple App List Tasks