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

دریافت نتایج Amazon Sellers بر اساس id

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

DataForSEO

​

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

دریافت نتایج Amazon Sellers بر اساس id

​

پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. این پاسخ می‌دهد چه کسانی دیگر در buy box هستند؛ خود محصول get_dataforseo_merchant_amazon_asin_fetch است. فقط وقتی به آن رجوع کنید که چیزی مشخص در نتیجه تحلیل‌شده کم باشد.

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

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

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

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

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

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

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

          • asin
            نوع: string | null

            asin دریافت‌شده در آرایه POST
            درباره ASINها در این راهنمای مرکز راهنما بیشتر بدانید

          • check_url
            نوع: string | null

            نشانی URL مستقیم نتایج Amazon
            می‌توانید از آن استفاده کنید تا مطمئن شوید نتایج ارائه‌شده دقیق هستند

          • datetime
            نوع: string | null

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

          • image
            نوع: string | null

            نشانی URL تصویر محصول
            نشانی URL تصویر محصول مرتبط با asin دریافت‌شده در آرایه POST

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

            انواع نتایج جستجوی یافت‌شده در Amazon Sellers SERP
            حاوی انواع همه نتایج جستجو (items) یافت‌شده در SERP بازگردانده‌شده است
            انواع آیتم ممکن:
            amazon_seller_main_item، amazon_seller_item

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

            آیتم‌های موجود در SERP

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

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

              • fixed_discount
                نوع: number | null

                مقدار تخفیف ثابت

              • fixed_discount_currency
                نوع: string | null

                کد ارز تخفیف ثابت

              • important_details
                نوع: string | null

                جزئیات مهم درباره شرایط کوپن‌های تخفیف

              • percentage_discount
                نوع: number | null

                مقدار تخفیف درصدی
                اگر تخفیف ثابت باشد، مقدار null خواهد بود

              • text
                نوع: string | null

                متن کوپن

              • type
                نوع: string | null

                نوع عنصر

            • condition
              نوع: string | null

              وضعیت محصول
              وضعیت محصولی که فروشنده ارائه می‌دهد

            • condition_description
              نوع: string | null

              جزئیات وضعیت محصول
              جزئیات گسترده درباره وضعیت محصولی که فروشنده ارائه می‌دهد

            • delivery_info
              نوع: object | null · Response36Afe1097B20_AmazonDeliveryInfo

              اطلاعات تحویل
              اطلاعات تحویل شامل بازه‌های تاریخ تحویل رایگان و سریع

              • delivery_date_from
                نوع: string | null

                زودترین تاریخی که محصول می‌تواند ارسال شود

              • delivery_date_to
                نوع: string | null

                دیرترین تاریخی که محصول می‌تواند تحویل داده شود

              • delivery_message
                نوع: string | null

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

              • delivery_price
                نوع: object | null · Response36Afe1097B20_PriceInfo

                هزینه تحویل هزینه تحویل بر اساس موقعیتی که در درخواست POST مشخص کرده‌اید؛ اگر تحویل رایگان در دسترس باشد، مقدار null است

                • 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

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

              • fastest_delivery_date_from
                نوع: string | null

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

              • fastest_delivery_date_to
                نوع: string | null

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

            • percentage_discount
              نوع: number | null

              مقدار تخفیف درصدی

            • position
              نوع: string | null

              ترازبندی عنصر در SERP
              مقادیر ممکن:
              left، right

            • price
              نوع: object | null · Response36Afe1097B20_PriceInfo

              جزئیات قیمت‌گذاری محصول
              اگر جزئیاتی وجود نداشته باشد، مقدار null خواهد بود

              • 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

              رتبه مطلق در SERP
              موقعیت مطلق در میان همه عناصر موجود در Amazon Sellers SERP

            • rank_group
              نوع: integer | null

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

            • rating
              نوع: object | null · Response36Afe1097B20_RatingElement

              جزئیات امتیاز فروشنده
              نرخ محبوبیت فروشنده بر اساس نظرات مشتریان

              • position
                نوع: string | null

                ترازبندی عنصر در Google Shopping SERP
                مقادیر ممکن:
                left، right

              • rating_max
                نوع: integer | null

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

              • rating_type
                نوع: string | null

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

              • type
                نوع: string | null

                نوع عنصر

              • value
                نوع: number | null

                مقدار امتیاز

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

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

            • seller_name
              نوع: string | null

              نام تجاری فروشنده

            • seller_url
              نوع: string | null

              نشانی URLی که به صفحه فروشنده در Amazon هدایت می‌کند

            • ships_from
              نوع: string | null

              نام شرکت فرستنده

            • type
              نوع: string | null

              نوع عنصر

            • xpath
              نوع: string | null

              XPath عنصر

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

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

          • language_code
            نوع: string | null

            کد زبان دریافت‌شده در آرایه POST

          • location_code
            نوع: integer | null

            کد موقعیت دریافت‌شده در آرایه POST

          • se_domain
            نوع: string | null

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

          • title
            نوع: string | null

            عنوان محصول
            عنوان محصول مرتبط با asin دریافت‌شده در آرایه POST

          • type
            نوع: string | 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 get/v1/beta/dataforseo/merchant/amazon/sellers/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/sellers/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": [
        {
          "asin": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "image": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "seller_name": null,
              "seller_url": null,
              "ships_from": null,
              "price": "[Max Depth Exceeded]",
              "percentage_discount": null,
              "applicable_vouchers": [
                "[Max Depth Exceeded]"
              ],
              "rating": "[Max Depth Exceeded]",
              "condition": null,
              "condition_description": null,
              "delivery_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Get Amazon Sellers Results by id