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

دریافت نتایج اطلاعات برنامه Apple بر اساس id

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

DataForSEO

​

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

دریافت نتایج اطلاعات برنامه Apple بر اساس id

​

صفحه فروشگاه یک برنامه App Store، از وظیفه‌ای که با post_dataforseo_app_apple_app_info_submit در صف قرار گرفته: توضیحات، توسعه‌دهنده، امتیاز، اندازه، نسخه و تصاویر. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. برای نظر کاربران از get_dataforseo_app_apple_app_reviews_fetch استفاده کنید.

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

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

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

پارامترهای مسیر
  • id
    نوع: string
    الزامی

    شناسه وظیفه
    شناسه وظیفه یکتا در سیستم ما با قالب UUID
    می‌توانید تا 30 روز از آن برای درخواست نتایج وظیفه در هر زمان استفاده کنید

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

          • 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

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

            اطلاعات اپلیکیشن یافت‌شده

            • advisories
              نوع: array (string | null)[] | null

              رده سنی و توصیه‌های محتوایی مبتنی بر سن

            • app_id
              نوع: string | null

              شناسه اپلیکیشن

            • categories
              نوع: array (string | null)[] | null

              همه دسته‌ها/ژانرهای مرتبط اپلیکیشن
              توجه: این فیلد فقط یک دسته مرتبط را در آرایه برمی‌گرداند

            • description
              نوع: string | null

              توضیحات اپلیکیشن

            • developer
              نوع: string | null

              نام توسعه‌دهنده اپلیکیشن

            • developer_id
              نوع: string | null

              شناسه توسعه‌دهنده اپلیکیشن

            • developer_url
              نوع: string | null

              نشانی URL صفحه توسعه‌دهنده در App Store

            • icon
              نوع: string | null

              نشانی URL آیکون اپلیکیشن

            • images
              نوع: array (string | null)[] | null

              تصاویر اپلیکیشن
              حاوی نشانی‌های URL تصاویر استفاده‌شده در صفحه اپلیکیشن در App Store است

            • is_free
              نوع: boolean | null

              نشان می‌دهد آیا اپلیکیشن رایگان است

            • languages
              نوع: array (string | null)[] | null

              زبان‌های پشتیبانی‌شده در اپلیکیشن
              توجه: این فیلد فقط یک زبان پشتیبانی‌شده را در آرایه برمی‌گرداند

            • last_update_date
              نوع: string | null

              تاریخ و زمان آخرین به‌روزرسانی اپلیکیشن
              با قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”؛
              مثال:
              2019-11-15 12:57:46 +00:00

            • main_category
              نوع: string | null

              دسته/ژانر اصلی اپلیکیشن

            • minimum_os_version
              نوع: string | null

              حداقل نسخه سیستم‌عامل لازم برای نصب اپلیکیشن

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

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

              • app_id
                نوع: string | null

                شناسه اپلیکیشن

              • title
                نوع: string | null

                عنوان اپلیکیشن

              • url
                نوع: string | null

                نشانی URL صفحه اپلیکیشن در Google Play

            • position
              نوع: string | null

              تراز عنصر در SERP
              می‌تواند مقادیر زیر را داشته باشد: left

            • price
              نوع: object | null · Response36Afe1097B20_PriceInfo

              قیمت اپلیکیشن

              • currency
                نوع: string | null

                واحد پول قیمت فهرست‌شده کد ISO واحد پول اعمال‌شده بر قیمت

              • current
                نوع: number | null قالب: double

                قیمت فعلی قیمت فعلی محصول یا خدمت نمایش‌داده‌شده در نتیجه را نشان می‌دهد

              • displayed_price
                نوع: string | null

                رشته قیمت در نتیجه رشته قیمت خام همان‌گونه که در نتیجه ارائه شده است

              • is_price_range
                نوع: boolean | null

                قیمت به‌صورت بازه ارائه می‌شود نشان می‌دهد آیا قیمت به‌صورت بازه ارائه شده است

              • max_value
                نوع: number | null قالب: double

                حداکثر قیمت حداکثر قیمت محصول یا خدمت همان‌گونه که در نتیجه ذکر شده است

              • regular
                نوع: number | null قالب: double

                قیمت عادی قیمت عادی محصول یا خدمت را بدون اعمال تخفیف نشان می‌دهد

            • rank_absolute
              نوع: integer | null

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

            • rank_group
              نوع: integer | null

              موقعیت در یک گروه از عناصر با مقادیر type یکسان
              موقعیت عناصر با مقادیر type متفاوت از rank_group حذف می‌شود

            • rating
              نوع: object | null · Response36Afe1097B20_RatingInfo

              میانگین امتیاز اپلیکیشن

              • rating_max
                نوع: integer | null

                حداکثر مقدار یک rating_type

              • rating_type
                نوع: string | null

                نوع امتیاز اینجا می‌توانید عناصر زیر را بیابید: Max5، Percents، CustomMax

              • value
                نوع: number | null قالب: double

                مقدار امتیاز

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

                میزان بازخورد

            • released_date
              نوع: string | null

              تاریخ و زمان انتشار اپلیکیشن
              در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”؛
              مثال:
              2019-11-15 12:57:46 +00:00
              توجه: این فیلد منسوخ است و همیشه null برمی‌گرداند

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

              تعداد کل نظرات اپلیکیشن

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

              اپلیکیشن‌های مشابه
              اپلیکیشن‌های مشابه اپلیکیشن را در درخواست POST نمایش می‌دهد

              • app_id
                نوع: string | null

                شناسه اپلیکیشن

              • title
                نوع: string | null

                عنوان اپلیکیشن

              • url
                نوع: string | null

                نشانی URL صفحه اپلیکیشن در Google Play

            • size
              نوع: string | null

              حجم اپلیکیشن

            • subtitle
              نوع: string | null

              زیرعنوان اپلیکیشن

            • title
              نوع: string | null

              عنوان اپلیکیشن

            • type
              نوع: string | null

              نوع عنصر

            • update_notes
              نوع: string | null

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

            • url
              نوع: string | null

              نشانی URL صفحه اپلیکیشن در App Store

            • version
              نوع: string | null

              نسخه فعلی اپلیکیشن

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

            تعداد آیتم‌ها در آرایه نتایج

          • language_code
            نوع: string | null

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

          • location_code
            نوع: integer | null

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

          • se_domain
            نوع: string | null

            دامنه موتور جستجو در آرایه POST

          • se_results_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 get/v1/beta/dataforseo/app_data/apple/app_info/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_info/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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": [
        {
          "app_id": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "app_id": null,
              "title": null,
              "subtitle": null,
              "url": null,
              "icon": null,
              "description": null,
              "reviews_count": null,
              "rating": "[Max Depth Exceeded]",
              "price": "[Max Depth Exceeded]",
              "is_free": null,
              "main_category": null,
              "categories": [
                "[Max Depth Exceeded]"
              ],
              "languages": [
                "[Max Depth Exceeded]"
              ],
              "advisories": [
                "[Max Depth Exceeded]"
              ],
              "developer": null,
              "developer_id": null,
              "developer_url": null,
              "version": null,
              "minimum_os_version": null,
              "size": null,
              "released_date": null,
              "last_update_date": null,
              "update_notes": null,
              "images": [
                "[Max Depth Exceeded]"
              ],
              "similar_apps": [
                "[Max Depth Exceeded]"
              ],
              "more_apps_by_developer": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}
Get Apple App Info Results by id