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

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (4.0.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Giglium from gravatar.com Giglium

Credits

Author: Giglium

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.6

Classifiers

Report project as malware

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.0a4.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.0a4-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vinted_scraper-3.0.0a4.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.0a4.tar.gz
Algorithm Hash digest
SHA256 98d058f4120c11582a7df6f04d615dff2b6dc01a7702d7d13ab0ee8536677aa4
MD5 69cc4d3ed58154ac88ce52d917893780
BLAKE2b-256 546e15be4fe21c03118d64499ec85556902038837a2625a97c000512b3c2e2b3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for vinted_scraper-3.0.0a4-py3-none-any.whl
Algorithm Hash digest
SHA256 cebeda2e8fbd48e83cf5482562c31a1e4177beade5d55c7f33dc558a67e4fb8d
MD5 124435281363966f54e78b4159e5643b
BLAKE2b-256 cc648979641dd76902f7adac977e8fba3a012e1f837f435d99074036caab6601

See more details on using hashes here.

Provenance

The following attestation bundles were made for vinted_scraper-3.0.0a4-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