{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.keywordbarrage.com/schemas/etsy-scraper-schema.json",
  "title": "EtsyData Extraction Engine Data Extraction Schema",
  "description": "Machine-readable DaaS extraction schema for EtsyData 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",
    "listing_title_etsy_listing_id",
    "listing_type"
  ],
  "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."
    },
    "listing_title_etsy_listing_id": {
      "type": "integer",
      "description": "Listing Title & Etsy Listing ID"
    },
    "listing_type": {
      "type": "array",
      "description": "Listing Type (Handmade, Vintage, Craft Supply)"
    },
    "price_discount_currency": {
      "type": "number",
      "description": "Price, Discount % & Currency"
    },
    "shop_name_star_seller_badge": {
      "type": "string",
      "description": "Shop Name & Star Seller Badge"
    },
    "shop_sales_count_star_rating": {
      "type": "string",
      "description": "Shop Sales Count & Star Rating (1-5★)"
    },
    "product_variations": {
      "type": "string",
      "description": "Product Variations (Color, Size, Personalization)"
    },
    "stock": {
      "type": "string",
      "description": "Stock / In Stock Delta (\"Only 1 left\")"
    },
    "favorited_by_count_in_baskets_count": {
      "type": "string",
      "description": "Favorited By Count & In Baskets Count"
    },
    "shipping_cost_delivery_estimation": {
      "type": "number",
      "description": "Shipping Cost & Delivery Estimation"
    },
    "detected_waf_stack": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Perimeter security technologies verified on origin platform.",
      "default": [
        "DataDome",
        "Varnish Cache",
        "Apache HTTP Server",
        "Pinterest Ads",
        "Microsoft Advertising",
        "DoubleClick Floodlight",
        "Google Analytics",
        "Facebook Pixel (Meta Ads)",
        "TikTok Pixel",
        "Pinterest Conversion Tag",
        "Google Tag Manager",
        "Transcend CMP",
        "Backbone.js",
        "Underscore.js",
        "Bootstrap",
        "Sentry",
        "web-vitals",
        "Priority Hints",
        "Pattern by Etsy",
        "Cart Functionality",
        "PWA",
        "Open Graph"
      ]
    }
  },
  "x-sector": "ecommerce-retail-marketplaces",
  "x-updated-date": "2026-10-08",
  "x-platform-slug": "etsy-scraper",
  "x-endpoint-url": "https://www.keywordbarrage.com/scrapers/etsy-scraper.html"
}