A real-time notification system for Vinted listings that works across all Vinted country domains. Get instant alerts when items matching your search criteria are posted.
- Web UI: Manage everything through an intuitive web interface
- Multi-Country Support: Works on all Vinted domains regardless of country
- Real-Time Notifications: Get instant alerts for new listings
- Multiple Search Queries: Monitor multiple search terms simultaneously
- Country Filtering: Filter items by seller's country of origin
- RSS Feed: Subscribe to your search results with any RSS reader
- Telegram Integration: Receive notifications directly in Telegram
- Python 3.11 or higher
- Telegram bot token (for Telegram notifications)
-
Clone the repository or download the latest release
git clone https://github.com/Fuyucch1/Vinted-Notifications.git cd Vinted-NotificationsAlternatively, download the latest release and extract it.
-
Install dependencies
pip install -r requirements.txt
-
Initial Configuration
The application can be configured through the Web UI after starting. However, you can also change the Web UI port in the
configuration_values.pyfile directly. -
Run the application
python vinted_notifications.py
Once started, access the Web UI at http://localhost:8000 to complete the setup.
The Web UI is the easiest way to manage the application. Access it at http://localhost:8000 after starting the application.
Features available in the Web UI:
- Dashboard: Overview of application status and recent items
- Queries Management: Add, remove, and view search queries
- Items Viewing: Browse and filter items found by the application
- Allowlist Management: Filter items by seller's country
- Configuration: Set up Telegram bot, RSS feed, and other settings
- Logs: View application logs directly from the web interface
After configuring your Telegram bot in the Web UI, you can use the following commands:
/add_query query- Add a search query to monitor/remove_query query_number- Remove a specific query/remove_query all- Remove all queries/queries- List all active queries/hello- Check if the bot is working/create_allowlist- Create a country allowlist (will slow down processing)/delete_allowlist- Delete the country allowlist/add_country XX- Add a country to the allowlist (ISO3166 format)/remove_country XX- Remove a country from the allowlist/allowlist- View the current allowlist
Queries must be added with a whole link. It works with filters.:
/add_query https://www.vinted.fr/catalog?search_text=nike%20shoes&price_to=50¤cy=EUR&brand_id[]=53
The RSS feed provides an alternative way to receive notifications. After enabling it in the Web UI, access it at http://localhost:8001.
The application supports using proxies to avoid rate limits. Those are configured in the configuration tab of the Web UI.
You can customize the notification message format:
# In configuration_values.py
MESSAGE = '''\
🆕 Title: {title}
💶 Price: {price}
🛍️ Brand: {brand}
<a href='{image}'>‍</a>
'''- Download the latest release
- Back up your
vinted_notifications.dbfile - Replace all files with the new ones
- Restart the application
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE.
- Thanks to @herissondev for maintaining pyVinted, a core dependency of this project.