# Vinted Scraper API – Cheapest Cross-Country Listings & Sellers (`lofomachines/vinted-scraper-api`) Actor

Scrape Vinted listings, prices, sellers and photos across 20+ countries. Search by keyword or paste a Vinted URL, filter by brand, size, condition and price, and get clean exportable data.

- **URL**: https://apify.com/lofomachines/vinted-scraper-api.md
- **Developed by:** [Lofomachines](https://apify.com/lofomachines) (community)
- **Categories:** E-commerce, Automation, MCP servers
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Vinted Scraper API – Cheapest Cross-Country Listings & Sellers 👗⚡

**The most complete *and* the cheapest Vinted scraper API on Apify.** Search second-hand fashion across **23 European & US Vinted marketplaces** at once, pull clean structured data for every listing, and export to **JSON, CSV, Excel or Google Sheets** in one click. No login. No setup. No headaches.

Whether you are a **reseller hunting for underpriced deals**, a **brand monitoring resale prices**, a **market researcher tracking second-hand fashion trends**, or a **developer building a product feed**, this Vinted scraper turns the world's biggest pre-owned clothing marketplace into a ready-to-use dataset.

---

### ✨ Why this Vinted scraper?

- 🌍 **True cross-country coverage** – Search France, Germany, Italy, Spain, the UK, the US, Poland, the Netherlands and 15+ more markets in a single run. Compare prices and availability between countries instantly.
- 🔎 **Search by keyword or paste a URL** – Type "nike air max" or simply paste any Vinted search/filter URL. Your filters are kept exactly as-is.
- 👤 **Full seller profiles** – Username, ratings, reputation, number of reviews, item count, followers and location for every listing.
- 🖼️ **Complete data** – Price, buyer-protection fees, brand, size, condition, all photos, favourites, views, status and direct links.
- ⚖️ **Balanced results** – Pick several countries and the results are split fairly across all of them, not just the first one.
- ⚡ **Fast & affordable** – Optimized to collect thousands of listings quickly while keeping your costs low.
- 🔐 **No account needed** – You never have to log in or share any credentials.

---

### 🚀 How to use it (60 seconds)

1. Click **Try for free / Start**.
2. Type one or more **search keywords** (e.g. `ralph lauren shirt`, `stone island`, `prada bag`) — or paste **Vinted search URLs**.
3. Pick the **countries** you want to search.
4. (Optional) Set a **price range**, **condition**, and **sort order**.
5. Click **Save & Start** and watch the dataset fill up.
6. **Export** your results to JSON, CSV, Excel, or Google Sheets — or pull them via API.

That's it. No proxies to configure, no tokens to paste, no technical knowledge required.

---

### 🧩 Example input

```json
{
  "searchTerms": ["nike vintage jacket", "carhartt pants"],
  "searchUrls": ["https://www.vinted.co.uk/catalog?search_text=stone%20island"],
  "countries": ["fr", "de", "it"],
  "maxItems": 100,
  "sortBy": "newest",
  "priceMin": 20,
  "priceMax": 150,
  "condition": ["new_with_tags", "very_good"],
  "includeSellerDetails": true
}
````

> **Tip:** `maxItems` is applied **per keyword and per country**. The example above
> (2 keywords × 3 countries + 1 URL) can return up to **700 listings** in one run.

### 📄 Example output

Every listing is returned as a clean, flat JSON object:

```json
{
  "id": 9098027308,
  "url": "https://www.vinted.fr/items/9098027308-jacket-full-zip-nike-vintage",
  "title": "Jacket full-zip nike vintage",
  "price": 19.5,
  "serviceFee": 1.68,
  "priceWithFees": 21.18,
  "currency": "EUR",
  "brand": "Nike",
  "size": "M / 38 / 10",
  "condition": "Très bon état",
  "status": "active",
  "isPromoted": true,
  "favouritesCount": 62,
  "viewsCount": 184,
  "photos": [
    "https://images1.vinted.net/tc/04_01d4a_PaZdWgCZHFUzozaibzxPV7Z5/1780697910.jpeg",
    "https://images1.vinted.net/tc/01_00ada_SqTHvi4EDVrVzm9v6BnZUkuy/1780697910.jpeg"
  ],
  "thumbnailUrl": "https://images1.vinted.net/t/04_01d4a_PaZdWgCZHFUzozaibzxPV7Z5/f800/1780697910.jpeg",
  "country": "fr",
  "marketplace": "www.vinted.fr",
  "seller": {
    "id": 3155302469,
    "username": "nulo_fr",
    "profileUrl": "https://www.vinted.fr/member/3155302469-nulofr",
    "feedbackCount": 28,
    "positiveFeedbackCount": 27,
    "feedbackReputation": 0.96,
    "itemCount": 41,
    "followersCount": 10,
    "city": "Lisboa",
    "country": "Portugal",
    "isBusiness": false,
    "avatarUrl": "https://images1.vinted.net/t/05_02342_qcGJSofmGuDR9Y9pyyTeNv54/f800/1778602051.jpeg"
  },
  "sellerUsername": "nulo_fr",
  "scrapedAt": "2026-06-25T07:57:44.317Z"
}
```

***

### 💡 Popular use cases

#### 🛍️ Resellers & flippers

Find **underpriced items** across countries before anyone else. Sort by newest, filter by brand and condition, and compare prices between markets to buy low in one country and sell high in another.

#### 📈 Price monitoring & repricing

Track how much specific brands, models or categories sell for on the second-hand market. Run on a schedule to build a **price history** and power your repricing strategy.

#### 🔬 Market & trend research

Analyze thousands of listings to understand **demand, popular brands, average prices and sell-through signals** (favourites & views) in the booming pre-owned fashion sector.

#### 👗 Brand & authentication monitoring

Brands and agencies can monitor how their products are **resold, priced and described** across Europe, and spot suspicious listings.

#### 🧾 Product feeds & data enrichment

Developers can generate a clean, structured **product feed** for apps, dashboards, comparison tools or internal pipelines — already normalized and ready to use.

#### 🎯 Lead generation & sourcing

Identify **active power-sellers and pro accounts** by item count, ratings and reputation for sourcing or outreach.

***

### 📦 What you get – output fields

Each listing in the dataset includes:

| Field | Description |
|-------|-------------|
| `id` | Unique listing ID |
| `url` | Direct link to the listing |
| `title` | Listing title |
| `price` | Item price |
| `serviceFee` | Buyer-protection fee |
| `priceWithFees` | Total price including fees |
| `currency` | Marketplace currency (EUR, GBP, USD, PLN…) |
| `brand` | Brand name |
| `size` | Size label |
| `condition` | Item condition |
| `status` | active / sold / reserved |
| `isPromoted` | Whether the listing is boosted |
| `favouritesCount` | Number of favourites (demand signal) |
| `viewsCount` | Number of views |
| `photos` | All photo URLs |
| `thumbnailUrl` | Main thumbnail |
| `country` | Marketplace country code |
| `marketplace` | Marketplace domain |
| `seller` | Full seller profile object (username, ratings, reputation, reviews, item count, followers, location, business flag, avatar) |
| `sellerUsername` | Seller username (quick access) |
| `scrapedAt` | Timestamp of collection |

***

### 🌍 Supported marketplaces

🇫🇷 France · 🇩🇪 Germany · 🇮🇹 Italy · 🇪🇸 Spain · 🇬🇧 United Kingdom · 🇺🇸 United States · 🇳🇱 Netherlands · 🇧🇪 Belgium · 🇦🇹 Austria · 🇱🇺 Luxembourg · 🇵🇱 Poland · 🇨🇿 Czechia · 🇸🇰 Slovakia · 🇱🇹 Lithuania · 🇵🇹 Portugal · 🇸🇪 Sweden · 🇷🇴 Romania · 🇭🇺 Hungary · 🇭🇷 Croatia · 🇬🇷 Greece · 🇩🇰 Denmark · 🇫🇮 Finland · 🇮🇪 Ireland

***

### 📤 Export & integrations

Results are available as **JSON, CSV, Excel, XML and Google Sheets**, and through the **Apify API**. Because the Actor saves listings **continuously while it runs**, your integrations can start consuming data immediately — no need to wait for the run to finish.

#### 🔌 Integration ideas

- **🤖 Make / Zapier / n8n** – Trigger a scenario on each new run and route fresh listings into Airtable, Notion, a Google Sheet, or a CRM. Use the **Dataset → "Get items"** step to pull results.
- **🔔 Real-time alerts** – Schedule the Actor every few minutes on a tight filter (brand + size + max price) and send a **Slack / Discord / Telegram / email** alert whenever a new bargain appears.
- **🧮 Repricing & dashboards** – Pipe the dataset into **BigQuery, Postgres, Supabase or a Looker/Power BI dashboard** to track average prices and demand (favourites & views) per brand over time.
- **🛒 Resale automation** – Feed `priceWithFees`, `brand`, `condition` and `photos` straight into your own listing tool to cross-post inventory.
- **🧠 Webhooks** – Add an Apify **webhook** on `ACTOR.RUN.SUCCEEDED` to push the dataset URL to your backend the moment a run completes.
- **💻 Direct API** – `GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json` returns the data for any backend, in any language.

> 💡 **Pro tip:** keep `maxItems` modest and run **frequently on a schedule** rather than one huge run. You get fresher data, faster alerts, and an even lower cost per useful listing.

***

### ⏱️ Run it on a schedule

Combine this Vinted scraper with Apify **Schedules** to automatically monitor new listings, price drops or specific brands every hour or every day, and push fresh data straight into your tools.

***

### 🧰 More Actors by lofomachines

Power up your workflow with other fast, affordable Actors from the same author:

- 🚗 **[Automobile.it Car Listings Scraper](https://apify.com/lofomachines/automobile-it-scraper)** — Extract car listings, prices, specs, dealer info and images. Same marketplace price-monitoring playbook, applied to cars.
- 🕵️ **[Watson – Username Finder](https://apify.com/lofomachines/watson)** — Hunt for accounts by username across 700+ sources. Perfect for verifying or enriching sellers you discover on Vinted.
- 💬 **[Telegram Keyword Search Scraper](https://apify.com/lofomachines/telegram-keyword-search-scraper)** — Search messages by keyword across public Telegram channels. Great for spotting reseller deals and market chatter.
- 🔍 **[Keyword Shitter – Autocomplete Scraper](https://apify.com/lofomachines/keyword-shitter-autocomplete-scraper)** — Turn one seed keyword into thousands of long-tail search ideas. Find exactly which brands and items people are looking for.
- ⚡ **[Google Search Autocomplete: Cheaper, Faster, Reliable](https://apify.com/lofomachines/google-search-autocomplete-cheaper-faster-reliable)** — Extract Google autocomplete suggestions with full metadata for demand and trend research.

👉 **[See all Actors by lofomachines »](https://apify.com/lofomachines)**

***

### ❓ FAQ

**Do I need a Vinted account or login?**
No. You never log in or provide any credentials.

**Can I scrape multiple countries at once?**
Yes — select as many marketplaces as you like. Results are balanced fairly across the countries you choose.

**Can I use my existing Vinted filters?**
Absolutely. Paste any Vinted search URL and every filter you applied is preserved.

**How many listings can I collect?**
The **Maximum items** value applies per keyword and per country. For example, 100 with 2 keywords across 2 countries can return up to 400 listings. Results are saved continuously as they are collected.

**In which formats can I export the data?**
JSON, CSV, Excel, XML and Google Sheets, plus full API access.

***

### ⚖️ Fair use

This tool collects **publicly available** information only. Please use the data responsibly and in line with applicable laws and the terms of the platforms you work with.

***

#### Keywords

Vinted scraper, Vinted API, cheapest Vinted scraper, Vinted scraper API, scrape Vinted, Vinted data, Vinted listings, Vinted price tracker, Vinted reseller tool, second-hand fashion data, Vinted product scraper, Vinted seller scraper, Vinted monitor, cross-country Vinted, Vinted export CSV, Vinted dataset.

# Actor input Schema

## `searchTerms` (type: `array`):

What do you want to find on Vinted? Add one or more keywords, e.g. "nike air max", "ralph lauren shirt", "prada bag". Leave empty if you are pasting Vinted URLs below instead.

## `searchUrls` (type: `array`):

Already built a filtered search on Vinted? Just copy the address bar URL and paste it here. The scraper keeps all of your filters. You can mix and match URLs from different countries.

## `countries` (type: `array`):

Which Vinted country markets should be searched? Pick one or several. Only applies to keyword searches – pasted URLs always use their own country.

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

How many listings to collect for EACH keyword in EACH selected country. Example: 100 with 2 keywords and 2 countries can return up to 100 × 2 × 2 = 400 listings. Each pasted URL also returns up to this many. Keep it lower for quick tests.

## `sortBy` (type: `string`):

How Vinted should order the listings before they are collected.

## `priceMin` (type: `integer`):

Only keep listings priced at or above this amount (in the marketplace currency). Leave empty for no minimum.

## `priceMax` (type: `integer`):

Only keep listings priced at or below this amount (in the marketplace currency). Leave empty for no maximum.

## `condition` (type: `array`):

Filter by the condition sellers selected. Leave empty to include every condition.

## `includeSellerDetails` (type: `boolean`):

Add each seller's full profile (username, ratings, reviews count, reputation, location, follower count and more) to every listing. Recommended for sourcing and lead generation.

## Actor input object example

```json
{
  "searchTerms": [
    "nike vintage jacket",
    "carhartt pants"
  ],
  "searchUrls": [
    "https://www.vinted.co.uk/catalog?search_text=stone%20island"
  ],
  "countries": [
    "fr",
    "de",
    "it"
  ],
  "maxItems": 10,
  "sortBy": "relevance",
  "includeSellerDetails": true
}
```

# Actor output Schema

## `overview` (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 = {
    "searchTerms": [
        "pokemon"
    ],
    "countries": [
        "fr",
        "de",
        "it"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("lofomachines/vinted-scraper-api").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 = {
    "searchTerms": ["pokemon"],
    "countries": [
        "fr",
        "de",
        "it",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("lofomachines/vinted-scraper-api").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 '{
  "searchTerms": [
    "pokemon"
  ],
  "countries": [
    "fr",
    "de",
    "it"
  ]
}' |
apify call lofomachines/vinted-scraper-api --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Vinted Scraper API – Cheapest Cross-Country Listings & Sellers",
        "description": "Scrape Vinted listings, prices, sellers and photos across 20+ countries. Search by keyword or paste a Vinted URL, filter by brand, size, condition and price, and get clean exportable data.",
        "version": "1.0",
        "x-build-id": "c5Axb4NHEgX2xgzxK"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lofomachines~vinted-scraper-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lofomachines-vinted-scraper-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/lofomachines~vinted-scraper-api/runs": {
            "post": {
                "operationId": "runs-sync-lofomachines-vinted-scraper-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/lofomachines~vinted-scraper-api/run-sync": {
            "post": {
                "operationId": "run-sync-lofomachines-vinted-scraper-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchTerms": {
                        "title": "Search keywords",
                        "type": "array",
                        "description": "What do you want to find on Vinted? Add one or more keywords, e.g. \"nike air max\", \"ralph lauren shirt\", \"prada bag\". Leave empty if you are pasting Vinted URLs below instead.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchUrls": {
                        "title": "Vinted search URLs (optional)",
                        "type": "array",
                        "description": "Already built a filtered search on Vinted? Just copy the address bar URL and paste it here. The scraper keeps all of your filters. You can mix and match URLs from different countries.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "countries": {
                        "title": "Marketplaces (countries)",
                        "type": "array",
                        "description": "Which Vinted country markets should be searched? Pick one or several. Only applies to keyword searches – pasted URLs always use their own country.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "fr",
                                "de",
                                "it",
                                "es",
                                "uk",
                                "us",
                                "nl",
                                "be",
                                "at",
                                "lu",
                                "pl",
                                "cz",
                                "sk",
                                "lt",
                                "pt",
                                "se",
                                "ro",
                                "hu",
                                "hr",
                                "gr",
                                "dk",
                                "fi",
                                "ie"
                            ],
                            "enumTitles": [
                                "France (vinted.fr)",
                                "Germany (vinted.de)",
                                "Italy (vinted.it)",
                                "Spain (vinted.es)",
                                "United Kingdom (vinted.co.uk)",
                                "United States (vinted.com)",
                                "Netherlands (vinted.nl)",
                                "Belgium (vinted.be)",
                                "Austria (vinted.at)",
                                "Luxembourg (vinted.lu)",
                                "Poland (vinted.pl)",
                                "Czechia (vinted.cz)",
                                "Slovakia (vinted.sk)",
                                "Lithuania (vinted.lt)",
                                "Portugal (vinted.pt)",
                                "Sweden (vinted.se)",
                                "Romania (vinted.ro)",
                                "Hungary (vinted.hu)",
                                "Croatia (vinted.hr)",
                                "Greece (vinted.gr)",
                                "Denmark (vinted.dk)",
                                "Finland (vinted.fi)",
                                "Ireland (vinted.ie)"
                            ]
                        },
                        "default": [
                            "fr"
                        ]
                    },
                    "maxItems": {
                        "title": "Maximum items (per keyword & per country)",
                        "minimum": 100,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "How many listings to collect for EACH keyword in EACH selected country. Example: 100 with 2 keywords and 2 countries can return up to 100 × 2 × 2 = 400 listings. Each pasted URL also returns up to this many. Keep it lower for quick tests.",
                        "default": 10
                    },
                    "sortBy": {
                        "title": "Sort results by",
                        "enum": [
                            "relevance",
                            "newest",
                            "price_low_to_high",
                            "price_high_to_low"
                        ],
                        "type": "string",
                        "description": "How Vinted should order the listings before they are collected.",
                        "default": "relevance"
                    },
                    "priceMin": {
                        "title": "Minimum price",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only keep listings priced at or above this amount (in the marketplace currency). Leave empty for no minimum."
                    },
                    "priceMax": {
                        "title": "Maximum price",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only keep listings priced at or below this amount (in the marketplace currency). Leave empty for no maximum."
                    },
                    "condition": {
                        "title": "Item condition",
                        "type": "array",
                        "description": "Filter by the condition sellers selected. Leave empty to include every condition.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "new_with_tags",
                                "new_without_tags",
                                "very_good",
                                "good",
                                "satisfactory"
                            ],
                            "enumTitles": [
                                "New with tags",
                                "New without tags",
                                "Very good",
                                "Good",
                                "Satisfactory"
                            ]
                        }
                    },
                    "includeSellerDetails": {
                        "title": "Include seller details",
                        "type": "boolean",
                        "description": "Add each seller's full profile (username, ratings, reviews count, reputation, location, follower count and more) to every listing. Recommended for sourcing and lead generation.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
