This release is a pre-release and may not be stable for production use.
Vinted Scraper
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
Beta
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 exampes to understand how they work.
To install the beta version with pip:
pip install vinted_scraper==3.0.0b1
Compatible from python 3.7+
For more info about the Beta 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 only working only on the Beta version (see #78), but it frequently throws a 403 error (see #58).
Parameters
name type data type description id required str The unique identifier of the item to retrieve params optional Dict I don't know if they exist
curl - (Perform an HTTP GET request to the given endpoint)
It is currently only working only on the Beta version
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
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vinted_scraper-3.0.0b3.tar.gz.
File metadata
- Download URL: vinted_scraper-3.0.0b3.tar.gz
- Upload date:
- Size: 11.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f85d5d24598e3f70c58977eab3f2846a4ef12985765d5bd1a63633ae333755e
|
|
| MD5 |
755e65a669282caf4089cb32f5af5b86
|
|
| BLAKE2b-256 |
bb5f8490afa12d3e53a9d191146453b84e910bb8729ab87ce88ac03030e58858
|
Provenance
The following attestation bundles were made for vinted_scraper-3.0.0b3.tar.gz:
Publisher:
release.yml on Giglium/vinted_scraper
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vinted_scraper-3.0.0b3.tar.gz -
Subject digest:
3f85d5d24598e3f70c58977eab3f2846a4ef12985765d5bd1a63633ae333755e - Sigstore transparency entry: 788706064
- Sigstore integration time:
-
Permalink:
Giglium/vinted_scraper@5a6800326c72f239ea5c16cbca2d8ec7cc41e5c3 -
Branch / Tag:
refs/tags/3.0.0b3 - Owner: https://github.com/Giglium
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@5a6800326c72f239ea5c16cbca2d8ec7cc41e5c3 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vinted_scraper-3.0.0b3-py3-none-any.whl.
File metadata
- Download URL: vinted_scraper-3.0.0b3-py3-none-any.whl
- Upload date:
- Size: 19.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c72dcf12ead39991f6bf1d92e2e8b2a7d98b24a867e6fada66b09f93722d7bb
|
|
| MD5 |
8740e64ebc0e91b76f7529c1c985a5a9
|
|
| BLAKE2b-256 |
baf6bdf078455b24999bb05bdbff0ff1b5c16e07dcd182dd7e16a017fd7e2143
|
Provenance
The following attestation bundles were made for vinted_scraper-3.0.0b3-py3-none-any.whl:
Publisher:
release.yml on Giglium/vinted_scraper
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vinted_scraper-3.0.0b3-py3-none-any.whl -
Subject digest:
4c72dcf12ead39991f6bf1d92e2e8b2a7d98b24a867e6fada66b09f93722d7bb - Sigstore transparency entry: 788706067
- Sigstore integration time:
-
Permalink:
Giglium/vinted_scraper@5a6800326c72f239ea5c16cbca2d8ec7cc41e5c3 -
Branch / Tag:
refs/tags/3.0.0b3 - Owner: https://github.com/Giglium
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@5a6800326c72f239ea5c16cbca2d8ec7cc41e5c3 -
Trigger Event:
push
-
Statement type:
