RedNote Shop Scraper

{
  "title": "RedNote Shop Scraper Input",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "productUrls": {
      "title": "Product URLs",
      "type": "array",
      "description": "Add one or more product page URLs to scrape. Example product URLs:\n\n- https://www.xiaohongshu.com/goods-detail/64f076e669262b000145d2c0",
      "prefill": [
        "https://www.xiaohongshu.com/goods-detail/64f076e669262b000145d2c0"
      ],
      "default": [],
      "editor": "stringList"
    },
    "categoryUrls": {
      "title": "List URLs",
      "type": "array",
      "description": "Add one or more List URLs to scrape.\n\nSupported page types with examples:\n\n- Seller page: https://www.xiaohongshu.com/barley/thanos/vendor/64f05eb7306a0d0001c65371\n\nLeave blank if using direct product URLs instead.\n\nThe `scrapeProductDetails` option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.",
      "prefill": [
        "https://www.xiaohongshu.com/barley/thanos/vendor/64f05eb7306a0d0001c65371"
      ],
      "default": [],
      "editor": "stringList"
    },
    "maxResultsPerScrape": {
      "title": "Maximum results",
      "type": "integer",
      "description": "Maximum number of product records to save.",
      "default": 20,
      "minimum": 1,
      "maximum": 100000
    },
    "usePagination": {
      "title": "Use pagination",
      "type": "boolean",
      "description": "If this option is enabled and a List URL has more than one page, the Actor continues through the following pages until it reaches the Maximum results limit. If the option is disabled, the Actor only scrapes the first page of each List URL.",
      "prefill": false,
      "default": true
    },
    "scrapeProductDetails": {
      "title": "Include product details",
      "type": "boolean",
      "default": true,
      "description": "If this option is enabled, the Actor visits each product page and adds the full product details to every record. If it is disabled, the Actor returns one list-level result record per product card.\n\nFields that are always included:\n\n- `url`\n- `product_id`\n- `sku`\n- `name`\n- `price`\n- `regular_price`\n- `currency`\n- `in_stock`\n- `main_image`\n- `seller_name`\n- `seller_rating_value`\n- `seller_url`\n- `price_label`\n- `scraped_at`\n\nFields that are only added when this option is enabled (set to true), and not added when it is disabled:\n\n- `description`\n- `images`\n- `canonical_url`\n- `coupon_summary`\n- `sold_count`\n- `seller_followers_count`\n- `seller_sold_count`\n- `selected_variant`\n- `shipping_origin`\n- `shipping_cost_text`\n- `dispatch_time_text`\n- `service_terms`"
    }
  }
}

{
  "actorSpecification": 1,
  "fields": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "product_id": {
        "type": [
          "string",
          "null"
        ],
        "description": "Stable source-side product identifier."
      },
      "name": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": {
        "type": [
          "string",
          "null"
        ]
      },
      "price": {
        "type": [
          "number",
          "null"
        ]
      },
      "regular_price": {
        "type": [
          "number",
          "null"
        ]
      },
      "currency": {
        "type": [
          "string",
          "null"
        ],
        "description": "ISO 4217 currency code."
      },
      "in_stock": {
        "type": [
          "boolean",
          "null"
        ]
      },
      "sku": {
        "type": [
          "string",
          "null"
        ]
      },
      "main_image": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "images": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "seller_name": {
        "type": [
          "string",
          "null"
        ]
      },
      "seller_url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "canonical_url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "scraped_at": {
        "type": "string",
        "format": "date-time"
      },
      "price_label": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed meaning of the selected current price, such as coupon-after price."
      },
      "coupon_summary": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed coupon type and threshold/discount summary."
      },
      "sold_count": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Exact product sold count displayed on the product page."
      },
      "seller_followers_count": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Exact seller follower count displayed on the product page."
      },
      "seller_sold_count": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Exact seller sold count displayed on the product page."
      },
      "selected_variant": {
        "type": [
          "string",
          "null"
        ],
        "description": "Meaningful option combination selected on the current product page."
      },
      "shipping_origin": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed dispatch origin."
      },
      "shipping_cost_text": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed shipping charge or free-shipping text."
      },
      "dispatch_time_text": {
        "type": [
          "string",
          "null"
        ],
        "description": "Displayed dispatch-time commitment."
      },
      "service_terms": {
        "type": [
          "array",
          "null"
        ],
        "description": "Displayed buyer-protection and return-service labels.",
        "items": {
          "type": "string"
        }
      },
      "seller_rating_value": {
        "type": [
          "number",
          "null"
        ],
        "description": "Seller rating score displayed in the seller-page header."
      }
    },
    "required": [
      "url",
      "name"
    ]
  },
  "views": {
    "overview": {
      "title": "Overview",
      "transformation": {
        "fields": [
          "main_image",
          "url",
          "product_id",
          "name",
          "price",
          "regular_price",
          "currency",
          "in_stock",
          "seller_name",
          "scraped_at"
        ]
      },
      "display": {
        "component": "table",
        "properties": {
          "main_image": {
            "label": "Image",
            "format": "image"
          },
          "url": {
            "label": "Product URL",
            "format": "link"
          },
          "product_id": {
            "label": "Product ID",
            "format": "text"
          },
          "name": {
            "label": "Product name",
            "format": "text"
          },
          "price": {
            "label": "Current price",
            "format": "number"
          },
          "regular_price": {
            "label": "Regular price",
            "format": "number"
          },
          "currency": {
            "label": "Currency",
            "format": "text"
          },
          "in_stock": {
            "label": "In stock",
            "format": "boolean"
          },
          "seller_name": {
            "label": "Seller",
            "format": "text"
          },
          "scraped_at": {
            "label": "Scraped at",
            "format": "datetime"
          }
        }
      }
    },
    "allFields": {
      "title": "All fields",
      "description": "Every stored field.",
      "transformation": {
        "fields": [
          "url",
          "product_id",
          "name",
          "description",
          "price",
          "regular_price",
          "currency",
          "in_stock",
          "sku",
          "main_image",
          "images",
          "seller_name",
          "seller_url",
          "canonical_url",
          "scraped_at",
          "price_label",
          "coupon_summary",
          "sold_count",
          "seller_followers_count",
          "seller_sold_count",
          "selected_variant",
          "shipping_origin",
          "shipping_cost_text",
          "dispatch_time_text",
          "service_terms",
          "seller_rating_value"
        ]
      },
      "display": {
        "component": "table"
      }
    }
  }
}