Search listings, explore sellers and compare sold prices across 27 markets. Get structured JSON from 76 public read operations, including reviews, suggested prices, catalog filters and shipping references. No Vinted account required.
No credit card required · PAYG credits never expire
import asyncio
from scrapebadger import ScrapeBadger
async def main():
async with ScrapeBadger(api_key="YOUR_API_KEY") as client:
results = await client.vinted.search.search(
query="Nike Air Max", market="fr",
price_to=50, status_ids="2", per_page=20
)
print(results.model_dump_json(indent=2))
asyncio.run(main()){
"items": [{
"id": 8523449950,
"title": "Nike Air Max 90",
"price": { "amount": "45.00", "currency_code": "EUR" },
"brand_title": null,
"display_title": "Nike",
"size_title": "42",
"status": "Très bon état",
"favourite_count": 34,
"url": "https://www.vinted.fr/items/8523449950"
}],
"pagination": { "total_entries": 960 }
}Search, item and seller endpoints, plus 76 public read operations through one catalog. Discover the available parameters and try each operation in the playground.
/v1/vinted/search_by_image/v1/vinted/search/v1/vinted/items/{id}/v1/vinted/users/{id}/v1/vinted/users/{id}/items/v1/vinted/brands/v1/vinted/colors/v1/vinted/statuses/v1/vinted/mobile/{operation}/v1/vinted/mobile/operations/v1/vinted/marketsCompare samples of similar sold listings and suggested price ranges by category, brand and condition.
Explore reviews, followers, wardrobes, related listings, homepage feeds and recommendations.
Look up categories, filters, ISBN metadata, package sizes, shipping references and help articles.
Sold comparables are samples, not a complete sales history. Displayed prices may differ from final negotiated prices. Browse all 76 operations →
Search and detail endpoints use these normalized fields. Labels can be localized and unavailable fields remain null. Read operations preserve their complete upstream JSON inside data.
idintegerUnique item identifiertitlestringListing title as entered by sellerbrand_titlestring | nullBrand when supplied; not inferred from display labelsdisplay_titlestring | nullOriginal listing presentation labelprice.amountstringPrice as decimal stringprice.currency_codestringISO 4217 currency (EUR, GBP, etc.)size_titlestringSize label in local formatstatusstringCondition (New with tags, Very good…)descriptionstringFull item description textfavourite_countintegerNumber of times item was favouritedcatalog_idinteger | nullCategory ID on item detailsphotosarrayPhoto objects with URLs and dimensionsis_reservedbooleanWhether item is reservedidintegerUnique seller identifierloginstringSeller usernamefeedback_reputationfloatRating score 0-5positive_feedback_countintegerTotal positive reviewscitystringSeller citycountry_codestring | nullSeller country codeitem_countintegerActive listings in wardrobelast_loged_on_tsstring | nullLast active timestamp, when availablefollowers_countintegerNumber of followersbusinessbooleanWhether seller is a business accountphoto_urlstringProfile photo CDN URLChoose the market for regional inventory, local currency, translated condition labels and shipping references. Listing visibility and available data vary by market.
No proxy setup. No session management. No anti-bot configuration.
Call any Vinted endpoint with your API key and parameters: query, market, price range, condition, or item ID. REST or SDK.
ScrapeBadger manages app API authentication and the requested market, with pooled connections for repeated requests.
Receive normalized JSON with typed fields, direct photo CDN links, and currency codes, ready to store, analyse, or pipe into your application.
Scraping Vinted gives you real-time peer-to-peer marketplace signals unavailable from retail datasets: brand activity, sold comparables, and cross-market price differences.
Track secondhand market prices for specific brands, sizes, and conditions across multiple Vinted country sites. Use sold comparables and suggested prices to inform resale pricing.
Monitor which brands have the most listings, favourite counts, and changing price ranges. Track repeated snapshots to spot shifts in marketplace activity.
Build tools that scan Vinted for undervalued listings matching specific criteria. Alert when items matching your keywords appear below a price threshold in a target market.
Analyse top Vinted sellers by market: listing volume, feedback score, average price points, and category focus. Useful for competitive research and partnership discovery.
Collect structured fashion data (item descriptions, condition labels, brand associations, and photo URLs) for training fashion classification models or recommendation engines.
Compare the same brand or category across vinted.fr, vinted.de, and vinted.co.uk to understand pricing differences, demand levels, and supply gaps between European markets.
You only pay for successful responses. Failed requests are always free. PAYG credits never expire; volume subscription tiers reduce per-credit cost further.
| Endpoint | Credits / request | PAYG | Subscription |
|---|---|---|---|
Search by Image /search_by_image | 10 credits | — | — |
Search Items /search | 5 credits | — | — |
Item Details /items/{id} | 10 credits | — | — |
User Profile /users/{id} | 3 credits | — | — |
User Items /users/{id}/items | 3 credits | — | — |
Search Brands /brands | 3 credits | — | — |
List Colors /colors | 1 credit | — | — |
List Conditions /statuses | 1 credit | — | — |
Read Operation /mobile/{operation} | 1 credit | — | — |
Discover Operations /mobile/operations | Free | — | — |
List Markets /markets | Free | — | — |
See the full plan comparison on the pricing page, subscription tiers step down per-credit cost beyond the cheapest column shown above.
Explore public Vinted data through a single API, with managed authentication and market routing.
Choose a market to retrieve regional inventory, local currency and translated labels. Compare countries with a separate request for each market.
Read public listings, seller information and reference data with your ScrapeBadger API key. Authentication and connection management are handled for you.
Get samples of similar sold listings and suggested price ranges by category, brand and condition. Sold samples are not a complete sales history or guaranteed final settlement prices.
Use normalized search and detail endpoints or explore the complete data returned by 76 public read operations. No HTML parsing required.
Each successful read operation costs one credit. Discovering operations is free. Existing search and detail endpoints retain their listed prices; failed requests are free.
Use SDKs for 12 languages, the CLI, or MCP tools. The playground includes parameter forms and request examples for every public operation.
Get started in minutes with Python, Node.js, or plain HTTP requests.
The scrapebadger Python library wraps the Vinted API with typed methods. Install with pip install scrapebadger, then start scraping Vinted in a few lines of code.
import asyncio
from scrapebadger import ScrapeBadger
async def main():
async with ScrapeBadger(api_key="YOUR_API_KEY") as client:
results = await client.vinted.search.search(
query="Nike", market="de", price_to=60,
per_page=20
)
for item in results.items[:3]:
detail = await client.vinted.items.get(
item.id, market="de"
)
if detail.item:
print(detail.item.title, detail.item.price.amount)
asyncio.run(main())import { ScrapeBadger } from 'scrapebadger'
const client = new ScrapeBadger({ apiKey: 'YOUR_API_KEY' })
const result = await client.vinted.readVintedMobileData(
'sold-comparables',
{
market: 'fr',
parameters: {
catalog_id: '1242',
brand_id: '53',
status_id: '2'
}
}
)
console.log(result.data.items)Common questions about scraping Vinted with the API, Python, Node.js, or REST.
Search listings by text or image, item descriptions and photos, seller profiles and wardrobes, reviews, followers, sold comparables, suggested prices, related listings, catalog filters, shipping references and help articles. The 76-operation catalog includes parameter schemas and examples. Fields depend on the endpoint and upstream availability; unavailable normalized fields remain null.
Choose from 27 market codes: FR, DE, GB, ES, IT, NL, BE, PT, PL, CZ, AT, SK, HU, RO, LU, LT, LV, EE, FI, DK, SE, GR, IE, SI, HR, US and AU. Market selects regional inventory, currency and labels. Availability varies by market and listing.
ScrapeBadger reads the JSON APIs used by the Vinted app and manages anonymous authentication and country routing. You need a ScrapeBadger API key, but no Vinted account, browser session or proxy setup.
Each successful /mobile/{operation} read costs 1 credit; /mobile/operations discovery is free. Image search costs 10 credits, text search 5, item details 10, seller profiles and wardrobes 3, brands 3, and colors and conditions 1. Listing markets is free. Failed requests are free. The pricing table shows current PAYG and subscription rates.
All endpoints return JSON. Search and detail endpoints use normalized schemas; public read operations return operation, market and upstream JSON in data. Prices retain their original currency code, labels can be localized, and unavailable fields remain null.
Yes. POST /v1/vinted/search_by_image with an image_url or image_base64 to find visually similar active listings. The playground also accepts local files. JPEG, PNG and WebP up to 5 MiB are supported. Choose a market and filter by price, brand, category or condition. A successful request costs 10 credits. Results include prices, photos and listing URLs, plus a similarity_score per item on the calls where Vinted returns a ranking. That score is Vinted’s own, on an unbounded scale it changes without notice, so use it to rank items inside one response rather than against a fixed cut-off.
Yes. Search supports query, catalog_ids, brand_ids, size_ids, material_ids, status_ids, color_ids, price_from, price_to, seller_country, page, per_page and order. Reuse pagination time and search_session_id across pages, and deduplicate by item ID.
Install scrapebadger 0.46.0 or later. Use the async ScrapeBadger client: await client.vinted.search.search(query="Nike", market="fr"), or await client.vinted.read_vinted_mobile_data("sold-comparables", payload={"market":"fr","parameters":{"catalog_id":"1242","brand_id":"53","status_id":"2"}}). See the runnable examples below.
Yes. New accounts receive 1,000 free credits without a credit card. That covers 1,000 one-credit read operations, 200 search requests or 100 item detail requests.
Per-request credit costs are listed above. For higher monthly volume, subscription tiers reduce the per-credit rate substantially. All Vinted endpoints (search, listings, profiles, brands across 27 markets) included on every plan.
1,000 free credits. No credit card. Get your API key in under a minute.
PAYG credits never expire · Pay only for successful requests · 27 markets included