سحب بيانات منتجات أمازون السعودية عبر API: الأسعار والبائعون والمخزون خطوة بخطوة (2026)

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"query": "مكينة قهوة", "country": "sa", "language": "AR"}'

{
  "query": "مكينة قهوة",
  "page": 1,
  "total_results_text": "48-1 من أكثر من 20,000 نتائج لـ مكينة قهوة",
  "count": 65,
  "products": [
    {
      "asin": "B00G5YOVZA",
      "title": "ماكينة تحضير قهوة اسبريسو دي انيسيا من نيسبريسو، لون أسود",
      "price": 340.01,
      "currency": "SAR",
      "rating": 4.3,
      "reviews_count": 46800,
      "is_sponsored": false,
      "position": 14,
      "badge": null,
      "sales_volume": null,
      "delivery": {
        "is_free": false,
        "date": "الاثنين، 16 نوفمبر",
        "fastest_date": "الثلاثاء، 10 نوفمبر"
      }
    }
  ]
}

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"query": "B00G5YOVZA", "country": "sa", "language": "AR"}'

{
  "asin": "B00G5YOVZA",
  "title": "ماكينة تحضير قهوة اسبريسو دي انيسيا من نيسبريسو، لون أسود",
  "brand": "Nespresso",
  "url": "https://www.amazon.sa/dp/B00G5YOVZA",
  "price": 340.01,
  "list_price": 695,
  "currency": "SAR",
  "rating": 4.3,
  "reviews_count": 46894,
  "has_buy_box": true,
  "availability": "متوفر",
  "max_quantity": 30,
  "sold_by": "Amazon Germany",
  "other_sellers_count": 5,
  "variants": [
    { "asin": "B07R4TS23R", "dimensions": { "اللون ": "أحمر" }, "is_selected": false, "is_available": true },
    { "asin": "B00G5YOVZA", "dimensions": { "اللون ": "أسود" }, "is_selected": true, "is_available": true },
    { "asin": "B011IY4MVY", "dimensions": { "اللون ": "ابيض" }, "is_selected": false, "is_available": true }
  ]
}

curl -X POST 'https://api.scavio.dev/api/v1/amazon/offers' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"asin": "B00G5YOVZA", "country": "sa", "language": "AR"}'

{
  "asin": "B00G5YOVZA",
  "rating": 4.3,
  "reviews_count": 46894,
  "note": "4 الخيارات الأخرى",
  "count": 5,
  "total_offers": 5,
  "has_more_pages": false,
  "offers": [
    {
      "condition": "جديد",
      "seller_id": "A2G5247R6UIDP1",
      "seller_name": "Amazon Germany",
      "ships_from": "Amazon Germany",
      "is_fulfilled_by_amazon": true,
      "is_buy_box_winner": true,
      "price": 340.01,
      "currency": "SAR",
      "list_price": 695,
      "shipping_price": 0,
      "discount_percentage": 51.08,
      "quantity": 30,
      "delivery": { "min_hours": 24, "max_hours": 72, "date": "الاثنين، 16 نوفمبر", "is_free": false }
    }
  ]
}

import requests, datetime

API = "https://api.scavio.dev/api/v1/amazon/offers"
HEADERS = {"Authorization": "Bearer sk_live_your_key"}

def snapshot(asin):
    r = requests.post(API, headers=HEADERS, timeout=90,
                      json={"asin": asin, "country": "sa", "language": "AR"})
    r.raise_for_status()
    offers = [o for o in r.json()["data"]["offers"] if o["price"] is not None]
    bb = next((o for o in offers if o["is_buy_box_winner"]), None)
    cheapest = min(offers, key=lambda o: o["price"] + (o["shipping_price"] or 0))
    return {
        "date": datetime.date.today().isoformat(),
        "asin": asin,
        "buy_box": (bb["seller_name"], bb["price"]) if bb else None,
        "cheapest": (cheapest["seller_name"], cheapest["price"]),
        "offers": len(offers),
    }

print(snapshot("B00G5YOVZA"))