# Shein Scraper (Product Listing by Keyword)

Scrape product name, details page URL, price, publish time, etc. from the SHEIN listing page by keyword.

- Template page: [https://www.octoparse.com/template/shein-scraper-product-listing-by-keyword](https://www.octoparse.com/template/shein-scraper-product-listing-by-keyword)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$2/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages, search-results pages.

## Output

The current workflow extracts 8 fields, including `UploadTime`, `discount`, `image`, `input_keyword`, `price_original`, `product_name`, `product_url`, `sale_price`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Keyword (up to 1,000 per run), Country and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keyword (up to 1,000 per run)

Required. keyword Constraints: minItems=1; maxItems=1000; items.minLength=1; items.maxLength=10000.

### Country

Optional. country Constraints: minLength=1; maxLength=10000.

## How to Use

# SHEIN Product Listing by Keyword Scraper

Collects structured records from SHEIN search results. Fields include `input_keyword`, `product_url`, `product_name`, `price_original`, `sale_price`, `image`, `UploadTime`, and `discount`.

## Input Parameters

- **Keyword** (Required) – Up to 1,000 entries per run.
- **Country** (Optional)

## Steps

1. Open `Shein Scraper (Product Listing by Keyword)` and click **Try it!**.
2. Fill in **Keyword** and **Country**.
3. Run the task in the Octoparse cloud.
4. After completion, review fields such as `product_name`, `product_url`, and `price_original`, then export.

## Tips

- Start with a focused keyword to validate output before scaling.
- Keep `input_keyword` in the export for traceability.

## Pricing

$2 per 1,000 output lines.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [eBay Spain Product Listing Scraper (by Keyword)](https://www.octoparse.com/template/ebay-listados-scraper)
- [Frávega Product Listing Scraper (Keyword)](https://www.octoparse.com/template/fravega-listados-scraper-palabra-clave)
- [Airbnb Scraper (by Keyword)](https://www.octoparse.com/template/airbnb-scraper-by-keyword)
- [Zillow Listing Scraper (by keyword)](https://www.octoparse.com/template/zillow-scraper-by-keywords)
- [Naver Map Scraper(by Keyword)](https://www.octoparse.com/template/naver-map-scraper)

## Input Schema

```json
{
  "title": "Shein Scraper (Product Listing by Keyword) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "title": "Keyword (up to 1,000 per run)",
      "description": "keyword",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "country": {
      "title": "Country",
      "description": "country",
      "type": "string",
      "minLength": 1,
      "maxLength": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keyword"
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "UploadTime": {
      "type": "string",
      "description": ""
    },
    "discount": {
      "type": "string",
      "description": ""
    },
    "image": {
      "type": "string",
      "description": ""
    },
    "input_keyword": {
      "type": "string",
      "description": ""
    },
    "price_original": {
      "type": "string",
      "description": ""
    },
    "product_name": {
      "type": "string",
      "description": ""
    },
    "product_url": {
      "type": "string",
      "description": ""
    },
    "sale_price": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Shein Scraper (Product Listing by Keyword) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

No verified real input/output examples are currently available.

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

No verified real input/output examples are currently available.

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `shein-scraper-product-listing-by-keyword`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/shein-scraper-product-listing-by-keyword.json)
- [Manifest](https://www.octoparse.com/templates/shein-scraper-product-listing-by-keyword-manifest.json)