{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.keywordbarrage.com/schemas/shopee-scraper-schema.json",
  "title": "ShopeeData Extraction Engine Data Extraction Schema",
  "description": "Machine-readable DaaS extraction schema for ShopeeData Extraction Engine under sector 'ecommerce-retail-marketplaces'. Optimized for LLM agents, RAG ingestion, and automated API callers.",
  "type": "object",
  "required": [
    "record_id",
    "target_url",
    "extraction_timestamp",
    "product_title_brand_model_subcategory_ta",
    "shopee_item_id"
  ],
  "properties": {
    "record_id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique deterministic ingestion identifier for the extracted record."
    },
    "target_url": {
      "type": "string",
      "format": "uri",
      "description": "Source URL inspected and extracted by KeywordBarrage engine."
    },
    "extraction_timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO-8601 UTC timestamp of execution."
    },
    "product_title_brand_model_subcategory_ta": {
      "type": "string",
      "description": "Product Title, Brand, Model & Sub-Category Taxonomy (e.g. Handphone & Aksesoris, Pakaian Pria)"
    },
    "shopee_item_id": {
      "type": "integer",
      "description": "Shopee Item ID (itemid), Shop ID (shopid) & Canonical Listing URL"
    },
    "selling_price_original_retail_price_disc": {
      "type": "number",
      "description": "Selling Price, Original Retail Price & Discount Percentage in Indonesian Rupiah (IDR Rp)"
    },
    "merchant_tier_status": {
      "type": "string",
      "description": "Merchant Tier & Status (Shopee Mall Official Store, Star+ Seller, Star Seller, Cross-Border)"
    },
    "seller_performance_ratings": {
      "type": "string",
      "description": "Seller Performance Ratings (Star Rating / 5.0, Chat Performance %, Shop Age & Total Followers)"
    },
    "stock_availability_variant_matrix": {
      "type": "array",
      "description": "Stock Availability & Variant Matrix (e.g. Model, Color, Storage Capacity with Exact Stock Delta)"
    },
    "promotional_vouchers_shopee_coins": {
      "type": "string",
      "description": "Promotional Vouchers & Shopee Coins (Gratis Ongkir XTRA, Cashback XTRA & Store Discount Coupons)"
    },
    "logistics_shipping_details": {
      "type": "object",
      "description": "Logistics & Shipping Details (SPX Express, COD Eligible, Origin City & Estimated Delivery Days)"
    },
    "customer_review_metrics": {
      "type": "integer",
      "description": "Customer Review Metrics (Historical Sold Count, Total Rating Count & Verified Buyer Photo/Video Reviews)"
    }
  },
  "x-sector": "ecommerce-retail-marketplaces",
  "x-updated-date": "2026-10-08",
  "x-platform-slug": "shopee-scraper",
  "x-endpoint-url": "https://www.keywordbarrage.com/scrapers/shopee-scraper.html"
}