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

الحصول على نتائج Amazon Sellers حسب المعرّف

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

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

الحصول على نتائج Amazon Sellers حسب المعرّف

​

الاستجابة مغلّفة في غلاف 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