# Poizon Listings Scraper (`piotrv1001/poizon-listings-scraper`) Actor

The POIZON Listings Scraper extracts product listings and enriched product pages from POIZON (Dewu), capturing titles, brands, prices, style codes, units sold, per-size resale prices and stock, specs, images and reviews in English — ideal for resale price tracking and catalogue matching.

- **URL**: https://apify.com/piotrv1001/poizon-listings-scraper.md
- **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 product listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 🚀 POIZON Listings Scraper

Easily extract product listings from **POIZON (得物 / Dewu)**, Asia's largest sneaker, streetwear and luxury resale marketplace. The **POIZON Listings Scraper** turns any search, category or brand page into a clean, structured dataset — **titles, prices, manufacturer style codes, per-size availability, specifications and customer reviews** — all in **English**, with no login and no manual clicking.

### ✨ Features

- 🏷️ **Comprehensive product data** — title, brand, category, image, price, units sold, release date and the manufacturer **style code** (e.g. `CW2288-111`) that lets you join POIZON data to StockX, GOAT, Nike or any retail catalogue.
- 📏 **Per-size resale prices** — every size is priced separately on POIZON. Turn on product details and you get a full size-by-size price, stock and delivery breakdown for each product.
- 🔍 **Search, category, brand or product URLs** — scrape by keyword, paste a category or brand page, or hand it a list of specific product URLs.
- 🌍 **English output** — titles, categories, specifications and size labels come back in English, not Chinese or Russian.
- ⭐ **Specs, images and reviews** — materials, closure type, colorway, the full image gallery, average rating and review count.
- ⚡ **Fast and cheap** — no browser needed, so hundreds of products per minute at a fraction of the cost of browser-based scrapers.

### 🛠️ How It Works

1. **Enter search queries** – type what you are looking for, e.g. `nike air force 1`, `jordan 4`, or a style code.
2. **Or paste URLs** – add POIZON category, brand, search or product URLs, e.g. `https://www.thepoizon.ru/brand/nike`.
3. **Choose your depth** – leave *Scrape product details* off for a fast, cheap catalogue sweep, or turn it on for per-size prices, specs and reviews.
4. **Set a limit and run** – results stream into the dataset and can be downloaded as JSON, CSV, Excel, HTML or XML, or pulled through the Apify API.

### 📥 Input

| Field                | Type    | Description                                                                |
| -------------------- | ------- | -------------------------------------------------------------------------- |
| `searchQueries`      | array   | Keywords to search for on POIZON.                                          |
| `startUrls`          | array   | POIZON category, brand, search or product URLs.                            |
| `maxItems`           | integer | Maximum number of products to save (default `50`).                         |
| `scrapeDetails`      | boolean | Also collect per-size prices, specs, images and reviews (default `false`). |
| `proxyConfiguration` | object  | Optional proxy settings.                                                   |

```json
{
    "searchQueries": ["nike air force 1"],
    "startUrls": [{ "url": "https://www.thepoizon.ru/brand/nike" }],
    "maxItems": 50,
    "scrapeDetails": false
}
```

### 📊 Sample Output Data

With **Scrape product details** turned off — fast catalogue data:

```json
{
    "spuId": 8900006958407506,
    "url": "https://www.thepoizon.ru/product/nike-air-force-1-low-07-triple-white-8900006958407506",
    "title": "Nike Air Force 1 Low '07 'Triple White'",
    "articleNumber": "CW2288-111",
    "brandName": "Nike",
    "brandId": 144,
    "googleProductCategory": "Apparel & Accessories > Shoes",
    "price": 8950,
    "currency": "RUB",
    "priceFormatted": "8,950 ₽",
    "imageUrl": "https://cdn-img.thepoizon.ru/pro-img/origin-img/20260703/dc5a5e9bac6c49afa2c6a34f25747312.jpg",
    "soldLabel": "2.5M sold",
    "releaseDate": "2021-02-14T16:00:00.000Z"
}
```

With **Scrape product details** turned on, every product additionally carries specifications, images, ratings, reviews and the size-by-size price breakdown:

```json
{
    "spuId": 8900006958407506,
    "title": "Nike Air Force 1 Low '07 'Triple White'",
    "articleNumber": "CW2288-111",
    "brandName": "Nike",
    "categoryName": "Sneakers",
    "gender": "unisex",
    "sizeSystem": "RU",
    "properties": {
        "Upper Material": "Cow Leather",
        "Sole Material": "Rubber",
        "Closure Type": "Lace-Up",
        "Colorway": "White",
        "Style ID": "CW2288-111"
    },
    "images": ["https://cdn.poizon.com/pro-img/origin-img/20260703/dc5a5e9bac6c49afa2c6a34f25747312.jpg"],
    "rating": 5,
    "reviewsCount": 410,
    "reviews": [
        {
            "score": 5,
            "variant": "Size: 39,5 RU (40,5 EU)",
            "author": "+***9",
            "publishedAt": "Jul 29, 2026"
        }
    ],
    "variants": [
        {
            "skuId": 8900076788237506,
            "size": "40,5",
            "color": "White",
            "edition": "Original Shoe Box Included",
            "price": 9250,
            "currency": "RUB",
            "priceFormatted": "9,250 ₽",
            "inStock": true,
            "deliveryEstimate": "9-12 days"
        }
    ],
    "variantsInStock": 17
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

### 🗂️ Data Fields

| Field                                   | Description                                                                       |
| --------------------------------------- | --------------------------------------------------------------------------------- |
| `spuId`                                 | POIZON product ID                                                                 |
| `url`                                   | Product page URL                                                                  |
| `title`                                 | Product title in English                                                          |
| `articleNumber`                         | Manufacturer style code (join key to StockX, GOAT, retail)                        |
| `brandName`, `brandId`                  | Brand                                                                             |
| `categoryName`, `googleProductCategory` | Category labels                                                                   |
| `price`, `currency`, `priceFormatted`   | Lowest listed price                                                               |
| `imageUrl`                              | Main product image                                                                |
| `soldLabel`                             | Units sold, e.g. `2.5M sold`                                                      |
| `releaseDate`                           | Original release date                                                             |
| `gender`, `ageRange`, `sizeSystem`      | Fit metadata *(details only)*                                                     |
| `properties`                            | Specifications: materials, closure, colorway, style ID *(details only)*           |
| `images`                                | Full image gallery *(details only)*                                               |
| `rating`, `reviewsCount`, `reviews`     | Ratings and customer reviews *(details only)*                                     |
| `variants`                              | Per-size `skuId`, `size`, `price`, `inStock`, `deliveryEstimate` *(details only)* |
| `variantsInStock`                       | Number of sizes currently available *(details only)*                              |

### 💰 How much does it cost to scrape POIZON?

This Actor uses **pay per event** pricing — you pay for the results you get, not for the time it runs.

| Event           | Price      | When it is charged                                             |
| --------------- | ---------- | -------------------------------------------------------------- |
| Product listing | **$0.002** | For each product saved without details                         |
| Item detail     | **$0.005** | For each product saved with per-size prices, specs and reviews |

That works out to roughly:

- **$2 per 1,000 products** for a catalogue sweep
- **$5 per 1,000 products** with full details, per-size pricing and reviews

The Apify Free plan includes $5 of monthly usage, which is enough for about **2,500 listings** or **1,000 fully detailed products** every month at no cost.

### 💡 Tips

- Start with `maxItems: 50` and `scrapeDetails: false` to preview what a query returns, then re-run deeper once you are happy with the results.
- Use the **style code** (`articleNumber`) to match POIZON products against StockX, GOAT or retail catalogues — it is the most reliable join key across marketplaces.
- Each individual search query, category or brand page returns up to **1,200 products**. To go wider, split your run across several narrower queries or brand pages instead of one broad one.
- Prices are listed in **RUB**; convert to your reporting currency downstream if needed.
- If you run very large jobs, enable **residential proxies** in the input to avoid rate limiting.

### ❓ FAQ

**Do I need a POIZON account?**
No. The Actor only reads publicly available product pages.

**Are the prices real resale prices?**
Yes — POIZON prices each size separately, and the `variants` array reflects what buyers actually pay per size, including delivery estimates.

**Why are reviews in Russian?**
Review text is written by buyers in their own language and is returned as published. Titles, categories and specifications are returned in English.

**Is scraping POIZON legal?**
This Actor collects publicly available data only. Web scraping of public data is generally legal in the EU and US, but you are responsible for how you use the data — do not collect personal data and comply with the applicable terms and regulations. If in doubt, consult a lawyer.

**Something is not working or I need a custom field.**
Open an issue on the Actor's **Issues** tab. Custom scraping solutions are available on request.

Start tracking POIZON resale prices with **POIZON Listings Scraper** today! 🚀

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search for on POIZON, for example a brand, a model name or a style code.

## `startUrls` (type: `array`):

POIZON category, brand, search or product URLs to scrape, for example https://www.thepoizon.ru/brand/nike

## `maxItems` (type: `integer`):

Maximum number of products to save across all search queries and start URLs.

## `scrapeDetails` (type: `boolean`):

Also open every product to collect per-size prices and availability, full specifications, all images and customer reviews. Slower, and priced higher per product.

## `proxyConfiguration` (type: `object`):

Proxy settings used for the requests.

## Actor input object example

```json
{
  "searchQueries": [
    "nike air force 1"
  ],
  "startUrls": [],
  "maxItems": 50,
  "scrapeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "nike air force 1"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("piotrv1001/poizon-listings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQueries": ["nike air force 1"] }

# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/poizon-listings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "nike air force 1"
  ]
}' |
apify call piotrv1001/poizon-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=piotrv1001/poizon-listings-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/wbzNy1bLAczGBfdbi/builds/yJLIS9TkLX2DMNHhl/openapi.json
