A very simple Python package for scraping Vinted. Supports both synchronous and asynchronous operations with automatic cookie management and typed responses.
📖 Full Documentation | 💡 Examples | 📝 Changelog
Install using pip:
pip install vinted_scraperThe package offers the following methods:
search - Gets all items from the listing page based on search parameters.
Parameters
name type data type description params optional Dict Query parameters like the pagination and so on
Returns: List[VintedItem] (VintedScraper) or Dict[str, Any] (VintedWrapper)
item - Reads item metadata (title, description, url, image) from the public item page.
The JSON item endpoint is blocked by the anti-bot protection and returns
403(see #59), so the data is read from the public item page instead. Only the fields exposed by the page's OpenGraph<head>tags are populated, and only the<head>is streamed (the full page body is not downloaded).
Parameters
name type data type description id required str The unique identifier of the item to retrieve fields optional List[str] OG fields to extract (defaults to all available)
Returns: Optional[VintedItem] (VintedScraper) or Optional[Dict[str, Any]] (VintedWrapper) — the metadata (e.g. result["description"]), or None if the page has no description.
curl - Perform an HTTP GET request to the given endpoint.
Parameters
name type data type description endpoint required str The endpoint to make the request to params optional Dict Query parameters like the pagination and so on
Returns: VintedJsonModel (VintedScraper) or Dict[str, Any] (VintedWrapper)
from vinted_scraper import VintedScraper
scraper = VintedScraper("https://www.vinted.com")
items = scraper.search({"search_text": "board games"})
for item in items:
print(f"{item.title} - {item.price}")Check out the examples for more!
To enable debug logging for troubleshooting:
import logging
# Configure logging BEFORE importing vinted_scraper
logging.basicConfig(
level=logging.DEBUG,
format="%(levelname)s:%(name)s:%(message)s"
)
from vinted_scraper import VintedScraper
scraper = VintedScraper("https://www.vinted.com")
scraper.search({"search_text": "board games"})Debug output (click to expand)
DEBUG:vinted_scraper._vinted_wrapper:Initializing VintedScraper(baseurl=https://www.vinted.com, user_agent=None, session_cookie=auto-fetch, config=None)
DEBUG:vinted_scraper._vinted_wrapper:Refreshing session cookie
DEBUG:vinted_scraper._vinted_wrapper:Cookie fetch attempt 1/3
DEBUG:vinted_scraper._vinted_wrapper:Session cookie fetched successfully: eyJraWQiOiJFNTdZZHJ1...
DEBUG:vinted_scraper._vinted_wrapper:Calling search() with params: {'search_text': 'board games'}
DEBUG:vinted_scraper._vinted_wrapper:API Request: GET /api/v2/catalog/items with params {'search_text': 'board games'}
DEBUG:vinted_scraper._vinted_wrapper:API Response: /api/v2/catalog/items - Status: 200-
403 Forbidden Error: The Vinted JSON item endpoint frequently returns 403 errors (#59). Because of this,
item()reads the item metadata from the public item page (a document navigation that is not blocked the same way) instead of the JSON API, so only the fields exposed by the page (title,description,url,image) are available. -
Cookie Fetch Failed: If cookies cannot be fetched:
- Verify the base URL is correct
- Check your internet connection, some VPN are banned. Try manually getting the cookie by running the following:
curl -v -c - -L "<base-url>" | grep access_token_web
This project is licensed under the MIT License - see the LICENSE file for details.
