Felo API PlatformFelo API Platform
همه endpointهای DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

شاخص‌های انبوه اپلیکیشن App Store (زنده)

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

DataForSEO

​

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

شاخص‌های انبوه اپلیکیشن App Store (زنده)

​

امتیازها، نظرات و برآورد نصب برای اپلیکیشن‌های App Store بسیاری در یک فراخوانی. این عملیات پارامتر limit ندارد، اما قیمت‌گذاری آن به‌ازای هر فراخوانی است نه هر آیتم، پس کل فهرست را یک‌جا ارسال کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. همتای Google Play: post_dataforseo_labs_google_bulk_app_metrics_live.

مرجع قیمت‌گذاری

  • اندازه‌گیری: هزینه گزارش‌شده پاسخ.
  • برآورد درخواست مرجع: 0.1356 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

بدنه
application/json
  • نوع: array (object | null)[]
    • app_ids
      نوع: array string[]

      شناسه‌های برنامه‌ها
      فیلد الزامی
      شناسه‌های برنامه‌های موبایل در App Store؛
      می‌توانید شناسه را در نشانی URL هر برنامه فهرست‌شده در App Store پیدا کنید؛
      نمونه:
      در نشانی URL https://apps.apple.com/us/app/id835599320
      شناسه 835599320 است؛
      حداکثر تعداد شناسه‌هایی که می‌توانید در این فیلد تعیین کنید 1000 است

    • language_code
      نوع: string | null

      کد زبان
      فیلد الزامی در صورت عدم تعیین language_name
      توجه: باید یکی از language_name یا language_code را تعیین کنید
      فهرست زبان‌های موجود همراه با language_code آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید؛
      توجه: این نقطه پایانی در حال حاضر فقط از زبان انگلیسی پشتیبانی می‌کند
      نمونه:
      en

    • language_name
      نوع: string

      نام کامل زبان
      فیلد الزامی در صورت عدم تعیین language_code
      توجه: باید یکی از language_name یا language_code را تعیین کنید
      فهرست زبان‌های موجود همراه با language_name آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید؛
      توجه: این نقطه پایانی در حال حاضر فقط از زبان انگلیسی پشتیبانی می‌کند؛
      نمونه:
      English

    • location_code
      نوع: integer

      کد مکان
      فیلد الزامی در صورت عدم تعیین location_name
      توجه: باید یکی از location_name یا location_code را تعیین کنید
      فهرست مکان‌های موجود همراه با location_code آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید؛
      توجه: این نقطه پایانی در حال حاضر فقط از مکان ایالات متحده پشتیبانی می‌کند؛
      نمونه:
      2840

    • location_name
      نوع: string

      نام کامل مکان
      فیلد الزامی در صورت عدم تعیین location_code
      توجه: باید یکی از location_name یا location_code را تعیین کنید
      فهرست مکان‌های موجود همراه با location_name آن‌ها را می‌توانید با ارسال یک درخواست جداگانه به
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages دریافت کنید؛
      توجه: این نقطه پایانی در حال حاضر فقط از مکان ایالات متحده پشتیبانی می‌کند؛
      نمونه:
      United States

    • tag
      نوع: string | null

      شناسه وظیفه تعریف‌شده توسط کاربر
      فیلد اختیاری
      محدودیت کاراکتر 255 است
      می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
      مقدار tag مشخص‌شده را در شیء data پاسخ پیدا می‌کنید

پاسخ‌ها
  • 200
    نوع: object | null · Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResponseInfo
    • cost
      نوع: number | null قالب: double

      هزینه کل وظایف، دلار آمریکا

    • status_code
      نوع: integer | null

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

    • status_message
      نوع: string | null

      پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

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

      آرایه‌ای از وظایف

      • نوع: object | null · Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveTaskInfo
        • 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

          آرایه‌ای از نتایج

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

            شامل داده‌های مربوط به معیارهای رتبه‌بندی برنامه مشخص‌شده است

            • app_id
              نوع: string | null

              شناسه اپلیکیشن در آرایه POST

            • metrics
              نوع: object | null

              معیارهای کلیدواژه‌های رتبه‌بندی‌شده برنامه
              داده‌های رتبه‌بندی مرتبط با کلیدواژه‌هایی که برنامه ارائه‌شده برای آن‌ها در Google Play رتبه دارد

              • propertyName
                نوع: object · Response36Afe1097B20_AppMetricsInfo
                • count
                  نوع: integer | null قالب: int64

                  تعداد کل SERPهای ارگانیک Amazon که محصول را در خود دارند

                • pos_1
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که محصول در آن‌ها رتبه #1 دارد

                • pos_11_100
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که محصول در آن‌ها رتبه #11-100 دارد

                • pos_2_3
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که محصول در آن‌ها رتبه #2-3 دارد

                • pos_4_10
                  نوع: integer | null

                  تعداد SERPهای ارگانیکی که محصول در آن‌ها رتبه #4-10 دارد

                • search_volume
                  نوع: integer | null قالب: int64

                  حجم کل جستجوی کلمات کلیدی رتبه‌گرفته محصول در SERP ارگانیک

            • se_type
              نوع: string | null

              نوع موتور جستجو

          • items_count
            نوع: integer | null قالب: int64

            تعداد نتایج بازگردانده‌شده در آرایه items

          • language_code
            نوع: string | null

            کد زبان در آرایه POST

          • location_code
            نوع: integer | null

            کد مکان در آرایه POST

          • se_type
            نوع: string | null

            نوع موتور جستجو

          • total_count
            نوع: integer | null قالب: int64

            مجموع کل نتایج در پایگاه داده ما مرتبط با درخواست شما

        • 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/dataforseo_labs/apple/bulk_app_metrics/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/bulk_app_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_ids": [
      "686449807",
      "382617920"
    ],
    "language_name": "English",
    "location_code": 2840
  }
]'
{
  "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": [
        {
          "se_type": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}
App Store Bulk App Metrics Live