Vinted OSINT

An OSINT tool for Vinted.com

Features

• Seller profile observations: Shows reported feedback, restrictions, photo flags, and verification information, with missing data listed explicitly. These observations do not establish reliability or fraud.
• Fetching User information: Retrieve details such as account status, preference settings, statistics, user information, verification methods, bundle discounts, and payment methods.
• Fetching multiple users: Batch process multiple user IDs from a file.
• No Login required: Extracts public information without needing a Vinted account.
• Pretty formatting: Uses rich and prettytable for colorful and highly readable terminal output, including colorized argument parsing help.
• Export data in multiple formats: Save retrieved data locally in JSON, CSV, HTML, LaTeX, or TXT formats.

Installation

• PyPI: pip install Vinted_OSINT
• Git: pip install git+https://github.com/EchterAlsFake/Vinted_OSINT.git
• From Source:

  git clone https://github.com/EchterAlsFake/Vinted_OSINT
  cd Vinted_OSINT
  pip install .
  

  (Note: The project uses pyproject.toml for modern dependency management. You can also use uv for faster installation.)

Usage

Fetch a single user:

Vinted_OSINT -u <user_id>

Fetch multiple users:

Vinted_OSINT --user_list <user_file>

-u and --user_list are mutually exclusive and cannot be used together.

Other arguments

You can view the full colorful help menu by running Vinted_OSINT -h.

• -e, --extension -> Specify a custom regional Vinted extension (default is .com), e.g., .fr or .de
• -c, --license -> Displays license and acknowledgements
• -a, --fetch_all -> Includes all returned API fields in the report
• --no_export -> If enabled, data won't be exported locally
• -f, --export_format -> Specify the export format (choices: json, csv, html, latex, txt. Exports are disabled unless a format is selected)

Credits / Acknowledgements

• Big thanks to: Vinted-API-Wrapper, which gave the idea on how to handle the authentication flow.
• Thanks to: keskivonfer for the inspiration.

Libraries used:

• eaf_base_api
• colorama
• prettytable
• rich
• rich-argparse

Contributions

Any contribution is appreciated. If you have feedback, issues, or want to help out, don't hesitate to open an issue or pull request!

License

Vinted OSINT is licensed under the GPLv3 License.
Copyright 2024-2026 Johannes Habel

Python usage

import asyncio
from Vinted_OSINT import OSINT

async def collect():
    client = OSINT(username_list="users.txt", extension=".com",
                   export_format="json", output_dir="exports", fetch_all=True)
    result = await client.start()
    print(result.users)     # Original user dictionaries, keyed by user ID
    print(result.failures)  # Errors for individual users

asyncio.run(collect())

Each successful user gets four files (main, photo, discount, payment) under <output-dir>/<user-id>/. Use --output-dir to choose the export root. JSON exports contain PrettyTable's header row followed by row objects; CSV, HTML, LaTeX, and TXT contain independently serialized tables. Existing files with the same user ID and format are overwritten. Batch processing continues after individual request, response, or export failures; the CLI exits with status 1 if any user fails, and 0 when all users succeed. Blank lines and duplicate IDs in user-list files are ignored. IDs must be numeric.

Testing

uv run --with pytest pytest -q            # Offline tests (default)
uv run --with pytest pytest -q -m live    # Optional live Vinted checks

Changes in 1.3.0

• Migrated to eaf_base_api 4.2 with explicit requests, authentication errors, and session cleanup.
• Fixed all export formats and per-user batch filenames.
• Replaced global options with constructor arguments and separated fetching from reports.
• Added batch failure summaries, response validation, and CLI exit statuses.
• Replaced seller scores and safety labels with observations and missing evidence.
• Added offline regression coverage and made live tests opt-in.