Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Vinted Scraper

Package Version Python Version codecov License FOSSA Status

A very simple Python package that scrapes the Vinted site to retrieve information about its items.

Installation

Stable

You can install Vinted Scraper using pip:

    pip install vinted_scraper==2.4.0

If you are on Python 3.6 you also have to install dataclasses: pip install dataclasses

Alpha

We move from requests to httpx to support Async API call. Now, you can await AsyncVintedScraper or AsyncVintedWrapper. I haven't finish to update all the docs but you can check async quick starts to understand how they work.

To install the alpha version with pip:

    pip install vinted_scraper==3.0.0a1

Compatible from python 3.8+

For more info about Alpha check the roadmap, and please if you find a bug open a issue!

Functions

The package offers the following functions:

search - (gets all the items present on the listing page)

Parameters

name type data type description
params optional Dict Query parameters like the pagination and so on
item - (gets the information about an item, and its seller present on the item detail page)

It is currently not working and will throw a 404 status code (see #78). Vinted has changed this endpoint, and we didn't find a replacement.

Parameters

name type data type description
id required str The unique identifier of the item to retrieve
params optional Dict I don't know is they exist

Usage

To obtain the scraped data as a vinted_scraper.models.VintedItem, so you can:

import vinted_scraper.VintedScraper


def main():
    scraper = VintedScraper("https://www.vinted.com")  # init the scraper with the baseurl
    params = {
        "search_text": "board games"
        # Add other query parameters like the pagination and so on
    }
    items = scraper.search(params)  # get all the items


if __name__ == "__main__":
    main()

VintedScraper returns structured data that are parsed and converted into a vinted_scraper.models.VintedItem object. If some attributes are None means that it wasn't found in the response, maybe because they are returned from other API. Also, I discard some attribute that I thought was useless but feel free to open an issue or a PR to add them.

If you want to manage the JSON response directly, you should use the VintedWrapper object instead of VintedScraper.

Here's the way of how to use it:

import vinted_scraper.VintedWrapper


def main():
    wrapper = VintedWrapper("https://www.vinted.com")  # init the scraper with the baseurl
    params = {
        "search_text": "board games"
        # Add other query parameters like the pagination and so on
    }
    items = wrapper.search(params)  # get all the items


if __name__ == "__main__":
    main()

License

This project is licensed under the MIT License - see the LICENSE file for details.

FOSSA Status

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vinted_scraper-3.0.0a2.tar.gz (33.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vinted_scraper-3.0.0a2-py3-none-any.whl (21.5 kB view details)

Uploaded Python 3

File details

Details for the file vinted_scraper-3.0.0a2.tar.gz.

File metadata

  • Download URL: vinted_scraper-3.0.0a2.tar.gz
  • Upload date:
  • Size: 33.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for vinted_scraper-3.0.0a2.tar.gz
Algorithm Hash digest
SHA256 886f4770f6bc24f0d6b8cfbbf10637771b3d9da31622dd6b69b37fe5f7c403b2
MD5 4b8f04c1c5f8b7bbe44cc06731a22e5c
BLAKE2b-256 386f5675b5bc315f13d9569f2cf8b061f7c09fadf7bff1db1c562ab026e3f52e

See more details on using hashes here.

Provenance

The following attestation bundles were made for vinted_scraper-3.0.0a2.tar.gz:

Publisher: release.yml on Giglium/vinted_scraper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vinted_scraper-3.0.0a2-py3-none-any.whl.

File metadata

File hashes

Hashes for vinted_scraper-3.0.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 a01ebcdfe05b49a6c7eac47bbe151010d8986dab533ca87c74e977eb612b1427
MD5 affe85a58378c6c400fd0bf8a94c03e7
BLAKE2b-256 6644a1e9e666b12d4a98d5d5687c13bc9273471ce8dd5a0b059edd8e843352ce

See more details on using hashes here.

Provenance

The following attestation bundles were made for vinted_scraper-3.0.0a2-py3-none-any.whl:

Publisher: release.yml on Giglium/vinted_scraper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page