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 Codacy Badge 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.0a3.tar.gz (11.0 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.0a3-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vinted_scraper-3.0.0a3.tar.gz
  • Upload date:
  • Size: 11.0 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.0a3.tar.gz
Algorithm Hash digest
SHA256 2e0c8c8e797f008a7bea49297142fed742adb7bb3458e4050576505228f0391d
MD5 735d7c13943a8a8282a1f65ac4d83430
BLAKE2b-256 b02fa5488e4e7a808e0f7d250a6b36f1529ca2f6d983e245ee3d70cd21af9627

See more details on using hashes here.

Provenance

The following attestation bundles were made for vinted_scraper-3.0.0a3.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.0a3-py3-none-any.whl.

File metadata

File hashes

Hashes for vinted_scraper-3.0.0a3-py3-none-any.whl
Algorithm Hash digest
SHA256 be643afae076d44aafb8db5e9193a74057fe345affd6ae86398dc190568ecd36
MD5 d7f12613eea1def6b93395850f632aca
BLAKE2b-256 c39fa3ef77761df8f7da4cb00cc3f136d111e165a1f6a234bb4f1b41574fa5aa

See more details on using hashes here.

Provenance

The following attestation bundles were made for vinted_scraper-3.0.0a3-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 Pingdom Monitoring Sentry Error logging StatusPage Status page