# Vinted API: Listings as JSON

**Use case:** 

Calls Vinted's own catalog endpoints and returns listings as JSON: id, title, price, brand, size, condition, seller and URL. Use it in place of a Vinted API that has no public listings endpoint, and pass maxProducts 0 to go past the 960 results Vinted gives one search.

## Input

```json
{
  "startUrls": [
    {
      "url": "https://www.vinted.com/catalog?referrer=item-crumbs&catalog[]=2632&order=newest_first&brand_ids[]=53&page=1"
    }
  ],
  "keywords": [
    "nike air force 1"
  ],
  "country": "gb",
  "maxProducts": 100,
  "includeDetails": false,
  "trackPriceChanges": false,
  "saveOnly": "all"
}
```

## Output

```json
{
  "photo.thumbnails.0.url": {
    "label": "Image",
    "format": "image"
  },
  "title": {
    "label": "Item Name",
    "format": "string"
  },
  "price.amount": {
    "label": "Price",
    "format": "string"
  },
  "url": {
    "label": "Link",
    "format": "string"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Vinted Scraper | From $0.75/1k 💙 Actor is ready to run with the inputs already set for "Vinted API: Listings as JSON". [Sign up or log in](https://console.apify.com/create-task-from-example/BOMlKTAWdBD8wJHgn) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Vinted API: Listings as JSON" task

The Vinted Scraper | From $0.75/1k 💙 Actor will start running based on the input automatically. You can also change all the input fields, like vinted urls, keywords, and more, to match your specific use case.

### 3. Receive the "Vinted API: Listings as JSON" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as image, item name, price, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Vinted API: Listings as JSON" task via API](https://apify.com/epicscrapers/vinted-search-scraper.md).

## FAQ

### Does Vinted have a public API for listings?

Vinted has no public listings API. The Vinted API JSON task calls Vinted's own catalog endpoints and returns listings as JSON, so you get listing data without building a client.

### How do I get Vinted listings as JSON?

The Vinted API JSON task takes keywords or catalog URLs and returns one JSON object per listing with id, title, price, brand, size, condition, seller and URL.

### What input does the Vinted API JSON task need?

The task needs one or more keywords and a country, or Vinted catalog URLs. maxProducts sets how many listings each search returns.

### How much data can this task return per search?

Vinted caps one search at 960 results. Set maxProducts to 0 to past that: the Vinted API JSON task splits searches by price and condition to return more.

### Can I run the Vinted API JSON task from my own code?

Yes. Start it with POST /v2/actor-tasks/{id}/runs and read the dataset through the API or the Apify JavaScript and Python clients.

### Which Vinted countries does the task support?

The Vinted API JSON task supports 26 sites, including vinted.co.uk, vinted.fr, vinted.de, vinted.it and vinted.es, and price filters use the country currency.

### Does the task need an API key or Vinted login?

No Vinted account or API key is needed. The Vinted API JSON task obtains its own Vinted session cookies, so only an Apify account is required.

### What fields does each Vinted listing contain?

Each listing has the Vinted item id, title, price and currency, photo URLs, brand, size, condition, seller name and the direct item URL.

### Can I get the item description and all photos?

Set includeDetails to add the description, every photo, colour, material, category, attributes and the seller rating to each listing.

### How often is Vinted data refreshed?

The Vinted API JSON task reads Vinted live on every run. Schedule it to rebuild the dataset on a fixed interval such as every hour or every day.

## About this Actor

This example demonstrates how to use [Vinted Scraper | From $0.75/1k 💙](https://apify.com/epicscrapers/vinted-search-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/epicscrapers/vinted-search-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/epicscrapers/vinted-search-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).