Search Vinted brands

Try in Playground

Find brand ids by keyword, with follower and listing counts and luxury/authenticity flags, for use as brand_ids in search.

GET/v1/vinted/brandsx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

keywordstringrequiredquery

Brand name fragment (1–100 characters).

min 1 chars · max 100 chars

Examplenike

domainenumquery

Marketplace domain suffix the data was read from (com, fr, de, co.uk, …).

one of: com, at, be, com.au, cz, de, dk, ee, es, fi, fr, gr, hr, hu, ie, it, lt, lu, lv, nl, pl, pt, ro, se, si, sk, co.uk

Examplefr

Response fields

requestIdstring

Random operational correlation ID.

Upstream requests (the anonymous token HEAD counts as one), response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data was retrieved.

statusenum

success, partial, failed or challenged. Inspect coverage even for HTTP 200.

one of: success, partial

sourceUrlstring

Public www.vinted.<domain> URL the data belongs to.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means this bounded read had no known omissions; warnings name each omission.

coverage.sourceenum

public_api for the JSON web API, public_page for the item page.

one of: public_api, public_page

coverage.completeboolean

False when any warning is present.

coverage.warningsstring[]

Machine-readable coverage information for this response.

domainenum

Marketplace domain suffix the data was read from (com, fr, de, co.uk, …).

one of: com, at, be, com.au, cz, de, dk, ee, es, fi, fr, gr, hr, hu, ie, it, lt, lu, lv, nl, pl, pt, ro, se, si, sk, co.uk

keywordstring

Brand name fragment (1–100 characters).

Matching brands in source order.

up to 96 items

brands.idstring

Brand id.

brands.titlestringnullable

Brand name.

brands.slugstringnullable

URL slug.

brands.urlstringnullable

Public brand page URL.

brands.favouriteCountintegernullable

Members following the brand.

brands.itemCountintegernullable

Listings the source counts for the brand.

brands.isLuxurybooleannullable

Luxury brand flag.

brands.isHvfbooleannullable

High-value fashion flag.

brands.requiresAuthenticityCheckbooleannullable

Listings may go through authenticity checks.

brands.isVisibleInListingsbooleannullable

Brand is shown on listings.

Source page state (the brand search answers one page).

pagination.pageintegernullable

Current page.

pagination.perPageintegernullable

Records per page.

pagination.totalPagesintegernullable

Total pages.

pagination.totalEntriesintegernullable

Total brands matched.

pagination.hasMoreboolean

Whether page + 1 exists.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts.
401	`unauthorized`	Missing or invalid service key.
404	`not_found`	Unknown item or member.
429	`upstream_rate_limited`	Vinted rate limited the request; no automatic retry.
502	`upstream_challenged`	DataDome/Cloudflare challenge, HTTP 401/403/503, or no anonymous token issued.
502	`unsupported_page` `unsafe_redirect` `response_too_large` `request_limit` `upstream_error`	Bounded retrieval failed, the page belongs to another item, or the response no longer matches the expected structure.
503	`busy`	All worker slots occupied.
504	`timeout`	Deadline exceeded.
200	`partial`	Coverage warnings such as pricing_missing, photos_missing or pagination_missing.

Code example

curl "https://api.scrapeatlas.com/v1/vinted/brands?keyword=nike&domain=fr" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vinted/brands?keyword=nike&domain=fr",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vinted/brands?keyword=nike&domain=fr",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Vinted request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/vinted/brands",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "keyword": "nike",
        "domain": "fr"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/vinted/brands?keyword=nike&domain=fr", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/vinted/brands?keyword=nike&domain=fr"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "domain": "fr",
  "keyword": "nike",
  "brands": [
    {
      "id": "53",
      "title": "Nike",
      "slug": "nike",
      "url": "https://www.vinted.fr/brand/53-nike",
      "favouriteCount": 8616567,
      "itemCount": 57066493,
      "isLuxury": true,
      "isHvf": true,
      "requiresAuthenticityCheck": true,
      "isVisibleInListings": true
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 30,
    "totalPages": 1,
    "totalEntries": 10,
    "hasMore": false
  },
  "sourceUrl": "https://www.vinted.fr/catalog?search_text=nike",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 2,
    "responseBytes": 46000,
    "durationMs": 640
  }
}

Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}