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

رقبای اپلیکیشن‌های Google Play (زنده)

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

DataForSEO

​

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

DataForSEO عملیات

رقبای اپلیکیشن‌های Google Play (زنده)

​

اپلیکیشن‌های Google Play که با یک اپ مشخص بر سر کلیدواژه‌های مشترک رقابت می‌کنند. صفحه‌بندی با limit، offset و offset_token؛ پس از صفحه‌های نخست از توکن استفاده کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. همتای Apple post_dataforseo_labs_apple_app_competitors_live است. برای کلیدواژه‌های پشت تقاطع از post_dataforseo_labs_google_app_intersection_live استفاده کنید.

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

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

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

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

      شناسه برنامه
      فیلد الزامی
      شناسه برنامه موبایل در Google Play؛
      می‌توانید شناسه را در نشانی URL هر برنامه فهرست‌شده در Google Play پیدا کنید؛
      نمونه:
      در نشانی URL https://play.google.com/store/apps/details?id=org.telegram.messenger
      شناسه org.telegram.messenger است

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

      آرایه‌ای از پارامترهای فیلتر نتایج
      فیلد اختیاری
      می‌توانید چندین فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
      باید بین شرط‌ها یک عملگر منطقی and یا or قرار دهید
      عملگرهای زیر پشتیبانی می‌شوند:
      <, <=, >, >=, =, <>, in, not_in
      نمونه:
      ["intersections",">",500]

      [["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]

      [[["intersections",">=",50],"and",["competitor_metrics.google_play_search_organic.pos_1","in",[1,5]]],
      "or",
      ["sum_position",">=","10000"]]

      برای اطلاعات بیشتر درباره فیلترها، به Dataforseo Labs - Filters یا این راهنمای مرکز راهنمایی مراجعه کنید

      شیء خالی
    • 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

    • limit
      نوع: integer | null

      حداکثر تعداد برنامه‌های برگردانده‌شده
      فیلد اختیاری
      مقدار پیش‌فرض: 100
      حداکثر مقدار: 1000

    • 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

    • offset
      نوع: integer | null

      افست در آرایه نتایج برنامه‌های برگردانده‌شده
      فیلد اختیاری
      مقدار پیش‌فرض: 0
      اگر مقدار 10 را تعیین کنید، ده برنامه اول در آرایه نتایج حذف می‌شود و داده‌ها برای کلیدواژه‌های بعدی ارائه می‌شود

    • order_by
      نوع: array string[] | null

      قواعد مرتب‌سازی نتایج
      فیلد اختیاری
      می‌توانید از همان مقادیر آرایه filters برای مرتب‌سازی نتایج استفاده کنید؛
      انواع مرتب‌سازی ممکن:
      asc - نتایج به ترتیب صعودی مرتب می‌شوند؛
      desc - نتایج به ترتیب نزولی مرتب می‌شوند؛
      برای تعیین نوع مرتب‌سازی باید از ویرگول استفاده کنید؛
      نمونه:
      ["intersections,asc"]
      توجه: در یک درخواست نمی‌توانید بیش از سه قاعده مرتب‌سازی تعیین کنید؛
      برای جداکردن چند قاعده مرتب‌سازی باید از ویرگول استفاده کنید؛
      نمونه:
      ["intersections,desc","sum_position,asc"]

      قاعده پیش‌فرض:
      ["intersections,desc"]
      توجه: اگر آرایه item_types شامل انواع آیتم متفاوت از organic باشد، نتایج بر اساس اولین نوع آیتم در آرایه مرتب می‌شوند

    • tag
      نوع: string | null

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

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

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

          • app_id
            نوع: string | null

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

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

            شامل داده‌های مربوط به app_id و برنامه‌های رقیب است

            • app_id
              نوع: string | null

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

            • avg_position
              نوع: number | null قالب: float

              میانگین موقعیت برنامه در SERP Google Play
              توجه: میانگین موقعیت فقط برای کلیدواژه‌های مشترک محاسبه می‌شود
              مقدار برای یک برنامه مشخص ممکن است هنگام ترکیب با برنامه‌های هدف متفاوت باشد

            • competitor_metrics
              نوع: object | null

              معیارهای کلیدواژه‌های مشترک
              داده‌های رتبه‌بندی مرتبط با کلیدواژه‌هایی که برنامه رقیب ارائه‌شده با برنامه در درخواست POST مشترک دارد
              توجه: در این آرایه، داده‌های رتبه‌بندی برای app_id رقیب برگردانده‌شده ارائه می‌شود

              • 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 ارگانیک

            • full_metrics
              نوع: object | null

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

              • 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 ارگانیک

            • intersections
              نوع: integer | null

              تعداد کلیدواژه‌های مشترک

            • se_type
              نوع: string | null

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

            • sum_position
              نوع: integer | null

              مجموع همه موقعیت‌های برنامه در SERP Google Play
              توجه: مجموع موقعیت‌ها فقط برای کلیدواژه‌های مشترک محاسبه می‌شود
              مقدار برای یک برنامه مشخص ممکن است هنگام ترکیب با برنامه‌های هدف متفاوت باشد

          • 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/google/app_competitors/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "org.telegram.messenger",
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

{
  "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,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Google Play App Competitors Live