vinted-api-kit 1.0.1__tar.gz → 1.1.0__tar.gz

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vinted-api-kit
-Version: 1.0.1
+Version: 1.1.0
 Summary: Lightweight asynchronous Python client library for accessing Vinted API and scraping item data.
 Project-URL: Homepage, https://github.com/vlymar1/vinted-api-kit
 Project-URL: Documentation, https://github.com/vlymar1/vinted-api-kit
@@ -50,7 +50,6 @@ Description-Content-Type: text/markdown
 - 🚀 **Asynchronous** - Built with asyncio for high performance
 - 🌍 **Auto-locale Detection** - Automatically detects locale from URL
 - 🔍 **Item Search** - Search catalog with filters, sorting and pagination
-- 📦 **Item Details** - Get complete item information with rich metadata
 - 🍪 **Cookie Persistence** - Automatic session management with multiple storage formats
 - 🔐 **Proxy Support** - Simple string-based proxy configuration
 - 📊 **Type Hints** - Full typing support with Literal types for better IDE experience
@@ -165,22 +164,7 @@ raw_items = await client.search_items(
 
 ### Item Details
 
-> Fetch detailed information about a specific item:
-```python
-item = await client.item_details(
-    url="https://www.vinted.com/items/1234567890"
-)
-
-print(f"Title: {item.title}")
-print(f"Brand: {item.brand_title}")
-print(f"Size: {item.size_title}")
-print(f"Price: {item.price} {item.currency}")
-print(f"Total: {item.total_item_price}")
-print(f"Description: {item.description}")
-
-# Or get raw JSON
-raw_item = await client.item_details(url, raw_data=True)
-```
+> ⚠️ **Deprecated since 1.1.0.** Vinted removed the item details API, so `item_details()` raises `VintedDeprecatedError`.
 
 ### Parameters
 
@@ -352,8 +336,7 @@ vinted-api-kit/
 │   ├── constants.py    # Constants and type definitions
 │   ├── exceptions.py   # Custom exceptions
 │   └── utils.py        # Utility functions
-├── tests/              # Test suite
-└── examples/           # Usage examples
+└── tests/              # Test suite
 ```
 
 ### Testing

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/README.md

@@ -18,7 +18,6 @@
 - 🚀 **Asynchronous** - Built with asyncio for high performance
 - 🌍 **Auto-locale Detection** - Automatically detects locale from URL
 - 🔍 **Item Search** - Search catalog with filters, sorting and pagination
-- 📦 **Item Details** - Get complete item information with rich metadata
 - 🍪 **Cookie Persistence** - Automatic session management with multiple storage formats
 - 🔐 **Proxy Support** - Simple string-based proxy configuration
 - 📊 **Type Hints** - Full typing support with Literal types for better IDE experience
@@ -133,22 +132,7 @@ raw_items = await client.search_items(
 
 ### Item Details
 
-> Fetch detailed information about a specific item:
-```python
-item = await client.item_details(
-    url="https://www.vinted.com/items/1234567890"
-)
-
-print(f"Title: {item.title}")
-print(f"Brand: {item.brand_title}")
-print(f"Size: {item.size_title}")
-print(f"Price: {item.price} {item.currency}")
-print(f"Total: {item.total_item_price}")
-print(f"Description: {item.description}")
-
-# Or get raw JSON
-raw_item = await client.item_details(url, raw_data=True)
-```
+> ⚠️ **Deprecated since 1.1.0.** Vinted removed the item details API, so `item_details()` raises `VintedDeprecatedError`.
 
 ### Parameters
 
@@ -320,8 +304,7 @@ vinted-api-kit/
 │   ├── constants.py    # Constants and type definitions
 │   ├── exceptions.py   # Custom exceptions
 │   └── utils.py        # Utility functions
-├── tests/              # Test suite
-└── examples/           # Usage examples
+└── tests/              # Test suite
 ```
 
 ### Testing

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vinted-api-kit"
-version = "1.0.1"
+version = "1.1.0"
 description = "Lightweight asynchronous Python client library for accessing Vinted API and scraping item data."
 authors = [
     {name = "Lymar Volodymyr",email = "volodymyr.lymar1@gmail.com"},
@@ -71,6 +71,9 @@ all = ["format", "lint", "type-check", "test-cov"]
 [tool.hatch.build.targets.wheel]
 packages = ["vinted"]
 
+[tool.hatch.build.targets.sdist]
+include = ["vinted", "README.md", "LICENSE"]
+
 [tool.ruff]
 exclude = [
     ".git",

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/__init__.py

@@ -4,6 +4,7 @@ from vinted.exceptions import (
     VintedAPIError,
     VintedAuthError,
     VintedConfigError,
+    VintedDeprecatedError,
     VintedError,
     VintedNetworkError,
     VintedRateLimitError,
@@ -11,7 +12,7 @@ from vinted.exceptions import (
 )
 from vinted.models.item import CatalogItem, DetailedItem
 
-__version__ = "1.0.1"
+__version__ = "1.1.0"
 
 __all__ = [
     "VintedClient",
@@ -24,6 +25,7 @@ __all__ = [
     "VintedNetworkError",
     "VintedConfigError",
     "VintedValidationError",
+    "VintedDeprecatedError",
     "SortOrder",
     "StorageFormat",
 ]

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/api/catalog.py

@@ -8,7 +8,7 @@ and returns either raw JSON items or parsed `CatalogItem` instances.
 import logging
 import time
 from typing import Any, Union
-from urllib.parse import parse_qsl, urlparse
+from urllib.parse import parse_qsl, urljoin, urlparse
 
 from vinted.exceptions import VintedValidationError
 
@@ -50,7 +50,7 @@ class CatalogAPI(BaseAPI):
         """
         self._validate_catalog_url(url)
         self.session.configure_from_url(url)
-        api_url = f"{self.base_url}/api/v2/catalog/items"
+        api_url = f"{self.base_url}/web/gateway/svc-catalogue/items"
 
         params = self._build_params(url, per_page, page)
         params["time"] = timestamp or int(time.time())
@@ -69,7 +69,11 @@ class CatalogAPI(BaseAPI):
         if raw_data:
             return items
 
-        return [CatalogItem(raw_data=item) for item in items]
+        catalog_items = [CatalogItem(raw_data=item) for item in items]
+        for catalog_item in catalog_items:
+            catalog_item.url = urljoin(f"{self.base_url}/", catalog_item.url)
+
+        return catalog_items
 
     def _build_params(self, url: str, per_page: int, page: int) -> dict:
         """Build API query params from a public catalog URL.
@@ -83,17 +87,19 @@ class CatalogAPI(BaseAPI):
         catalog_id = self._extract_catalog_id(parsed.path)
         catalog_ids_query = self._join_values(query_params, "catalog[]")
 
+        status_ids = self._extract_values(query_params, "status_ids[]") + self._extract_values(
+            query_params, "status[]"
+        )
+
         params = {
             "search_text": "+".join(self._extract_values(query_params, "search_text")),
-            "catalog_ids": str(catalog_id) if catalog_id else catalog_ids_query,
-            "color_ids": self._join_values(query_params, "color_ids[]"),
-            "brand_ids": self._join_values(query_params, "brand_ids[]"),
-            "size_ids": self._join_values(query_params, "size_ids[]"),
-            "material_ids": self._join_values(query_params, "material_ids[]"),
-            "status_ids": self._join_values(query_params, "status[]"),
-            "country_ids": self._join_values(query_params, "country_ids[]"),
-            "city_ids": self._join_values(query_params, "city_ids[]"),
-            "is_for_swap": ",".join("1" for _ in self._extract_values(query_params, "disposal[]")),
+            "attribute_ids[catalog]": str(catalog_id) if catalog_id else catalog_ids_query,
+            "attribute_ids[color]": self._join_values(query_params, "color_ids[]"),
+            "attribute_ids[brand]": self._join_values(query_params, "brand_ids[]"),
+            "attribute_ids[size]": self._join_values(query_params, "size_ids[]"),
+            "attribute_ids[material]": self._join_values(query_params, "material_ids[]"),
+            "attribute_ids[status]": ",".join(status_ids),
+            "attribute_ids[patterns]": self._join_values(query_params, "patterns_ids[]"),
             "currency": self._join_values(query_params, "currency"),
             "price_to": self._join_values(query_params, "price_to"),
             "price_from": self._join_values(query_params, "price_from"),
@@ -113,10 +119,8 @@ class CatalogAPI(BaseAPI):
             raise VintedValidationError("Invalid catalog URL: expected an absolute HTTP(S) URL")
 
         path = parsed.path.rstrip("/")
-        if path and not (path.startswith("/catalog") or path == "/api/v2/catalog/items"):
-            raise VintedValidationError(
-                "Invalid catalog URL: expected path '/catalog' or '/api/v2/catalog/items'"
-            )
+        if path and not path.startswith("/catalog"):
+            raise VintedValidationError("Invalid catalog URL: expected path '/catalog'")
 
     @staticmethod
     def _extract_catalog_id(path: str) -> int | None:

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/api/items.py

@@ -6,10 +6,10 @@ URL and returns either a parsed `DetailedItem` or raw JSON.
 """
 
 import logging
-from typing import Any, Union
+from typing import Union
 from urllib.parse import urlparse
 
-from vinted.exceptions import VintedValidationError
+from vinted.exceptions import VintedDeprecatedError, VintedValidationError
 
 from ..models import DetailedItem
 from .base import BaseAPI
@@ -29,33 +29,18 @@ class ItemsAPI(BaseAPI):
         url: str,
         raw_data: bool = False,
     ) -> Union[DetailedItem, dict]:
-        """Fetch item details.
+        """Deprecated: always raises `VintedDeprecatedError`.
+
+        Vinted removed the item details API endpoint.
 
         Args:
             url: Public Vinted item URL.
             raw_data: If True, return raw JSON dictionary instead of
                 a `DetailedItem` instance.
-
-        Returns:
-            `DetailedItem` or raw dict depending on `raw_data`.
         """
-        self.session.configure_from_url(url)
-
-        product_id = self._extract_product_id(url)
-        api_url = f"{self.base_url}/api/v2/items/{product_id}/details"
-
-        logger.debug("Fetching item details: %s", api_url)
-
-        response = await self.session.request(api_url)
-        data = response.json()
-        item_data: dict[Any, Any] = data.get("item", {})
-
-        logger.debug("Item details fetched successfully")
-
-        if raw_data:
-            return item_data
-
-        return DetailedItem(raw_data=item_data)
+        raise VintedDeprecatedError(
+            "item_details() no longer works: Vinted removed the item details API"
+        )
 
     @staticmethod
     def _extract_product_id(url: str) -> str:

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/client.py

@@ -163,14 +163,13 @@ class VintedClient:
         url: str,
         raw_data: bool = False,
     ) -> Union[DetailedItem, dict]:
-        """Fetch item details by URL.
+        """Deprecated: always raises `VintedDeprecatedError`.
+
+        Vinted removed the item details API endpoint.
 
         Args:
             url: Item page URL or API endpoint.
             raw_data: When True returns raw dict instead of `DetailedItem`.
-
-        Returns:
-            `DetailedItem` or raw dict when `raw_data` is True.
         """
         return await self._items.get_details(url=url, raw_data=raw_data)
 

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/exceptions.py

@@ -59,3 +59,7 @@ class VintedConfigError(VintedError):
 
 class VintedValidationError(VintedError):
     """Raised when input validation fails."""
+
+
+class VintedDeprecatedError(VintedError):
+    """Raised when a deprecated feature no longer works with the Vinted API."""

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/models/item.py

@@ -8,6 +8,8 @@ from dataclasses import dataclass, field
 from datetime import datetime, timezone
 from typing import Any
 
+from ..exceptions import VintedDeprecatedError
+
 
 @dataclass
 class CatalogItem:
@@ -15,7 +17,12 @@ class CatalogItem:
 
     The class stores the original `raw_data` (hidden from the repr)
     and extracts commonly-used fields like `id`, `title`, `price` and
-    `photo` for convenience.
+    `photo` for convenience. Brand, size and condition come from
+    `item_box` in the language of the Vinted domain.
+
+    `created_at_ts` and `raw_timestamp` are deprecated: the catalog API
+    no longer returns the photo timestamp, so they always hold epoch
+    and 0. They will be removed in the next major release.
     """
 
     raw_data: dict[str, Any] = field(repr=False)
@@ -23,8 +30,10 @@ class CatalogItem:
     title: str = field(init=False)
     brand_title: str = field(init=False)
     size_title: str = field(init=False)
+    condition: str = field(init=False)
     currency: str = field(init=False)
     price: float = field(init=False)
+    total_item_price: float = field(init=False)
     photo: str = field(init=False)
     url: str = field(init=False)
     created_at_ts: datetime = field(init=False)
@@ -33,12 +42,19 @@ class CatalogItem:
     def __post_init__(self):
         self.id = self.raw_data.get("id", 0)
         self.title = self.raw_data.get("title", "")
-        self.brand_title = self.raw_data.get("brand_title", "")
-        self.size_title = self.raw_data.get("size_title", "")
+
+        item_box = self.raw_data.get("item_box") or {}
+        self.brand_title = item_box.get("first_line", "")
+        # second_line is "<size> · <condition>", the size part is optional
+        *sizes, self.condition = item_box.get("second_line", "").split(" · ")
+        self.size_title = sizes[0] if sizes else ""
 
         price = self.raw_data.get("price") or {}
         self.currency = price.get("currency_code", "")
-        self.price = price.get("amount", 0.0)
+        self.price = float(price.get("amount") or 0.0)
+
+        total_item_price = self.raw_data.get("total_item_price") or {}
+        self.total_item_price = float(total_item_price.get("amount") or 0.0)
 
         photo = self.raw_data.get("photo") or {}
         self.photo = photo.get("url", "")
@@ -69,13 +85,19 @@ class CatalogItem:
         return hash(self.id)
 
     def is_new_item(self, minutes: int = 1) -> bool:
-        """Return True when the item was created within `minutes`.
+        """Deprecated: always raises `VintedDeprecatedError`.
+
+        The check compared `created_at_ts` with the current time, but the
+        catalog API no longer returns the photo timestamp. The method will
+        be removed in the next major release.
 
         Args:
             minutes: Age threshold in minutes (default: 1).
         """
-        delta = datetime.now(timezone.utc) - self.created_at_ts
-        return delta.total_seconds() < minutes * 60
+        raise VintedDeprecatedError(
+            "CatalogItem.is_new_item() no longer works: the Vinted catalog API "
+            "does not return item timestamps anymore"
+        )
 
 
 @dataclass

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/session.py

@@ -28,7 +28,7 @@ from .constants import (
     HTTP_STATUS_UNAUTHORIZED,
 )
 from .storage import CookieStorage
-from .utils import format_proxy_for_log, get_accept_language
+from .utils import format_proxy_for_log, get_accept_language, get_locale_code
 
 logger = logging.getLogger(__name__)
 
@@ -93,7 +93,10 @@ class HttpSession:
         if host.startswith("vinted."):
             self.locale = host[len("vinted.") :]
             accept_language = get_accept_language(self.locale)
-            self.session.headers.update({"Accept-Language": accept_language})
+            # `locale` selects the marketplace whose items the catalog returns
+            self.session.headers.update(
+                {"Accept-Language": accept_language, "locale": get_locale_code(self.locale)}
+            )
 
         self.session.headers.update({"Referer": self.base_url})
         logger.debug("Configured: base_url=%s, locale=%s", self.base_url, self.locale)

{vinted_api_kit-1.0.1 → vinted_api_kit-1.1.0}/vinted/utils.py

@@ -28,12 +28,17 @@ def format_proxy_for_log(proxy: str | None) -> str:
     return proxy
 
 
+def get_locale_code(locale: str) -> str:
+    """Return the full locale code for `locale` (e.g. "sk" -> "sk-SK")."""
+    return LOCALE_TO_ACCEPT_LANGUAGE.get(locale, "en-US")
+
+
 def get_accept_language(locale: str) -> str:
     """Return an Accept-Language header value for `locale`.
 
     The returned value contains the full locale code and a fallback
     language prefix with a lower q-value.
     """
-    locale_code = LOCALE_TO_ACCEPT_LANGUAGE.get(locale, "en-US")
+    locale_code = get_locale_code(locale)
     lang_prefix = locale_code.split("-")[0]
     return "%s,%s;q=0.9" % (locale_code, lang_prefix)

vinted_api_kit-1.0.1/.editorconfig

@@ -1,22 +0,0 @@
-root = true
-
-[**]
-charset = utf-8
-end_of_line = lf
-indent_size = 4
-indent_style = space
-insert_final_newline = true
-trim_trailing_whitespace = true
-max_line_length = 99
-
-[**.{yml,yaml,json,conf}]
-indent_size = 2
-
-[**.{md,txt,rst}]
-trim_trailing_whitespace = false
-
-[**.rst]
-indent_size = 2
-
-[Makefile]
-indent_style = tab

vinted_api_kit-1.0.1/.github/workflows/ci.yaml

@@ -1,35 +0,0 @@
-name: CI
-
-on:
-  push:
-  pull_request:
-
-jobs:
-  lint-and-test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
-    name: Lint, Type Check & Test (Python ${{ matrix.python-version }})
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install hatch and create env
-        run: |
-          python -m pip install --upgrade pip
-          pip install hatch
-
-      - name: Run linting
-        run: hatch run lint
-
-      - name: Run type check
-        run: hatch run type-check
-
-      - name: Run tests (no coverage)
-        run: hatch run test

vinted_api_kit-1.0.1/.github/workflows/coverage.yaml

@@ -1,31 +0,0 @@
-name: Coverage
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  coverage:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install hatch
-
-      - name: Run tests with coverage
-        run: hatch run pytest --cov=vinted --cov-branch --cov-report=xml
-
-      - name: Upload results to Codecov
-        uses: codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}

vinted_api_kit-1.0.1/.pre-commit-config.yaml

@@ -1,27 +0,0 @@
-repos:
-- repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v5.0.0
-  hooks:
-    - id: trailing-whitespace
-    - id: end-of-file-fixer
-    - id: check-yaml
-    - id: check-toml
-    - id: check-case-conflict
-    - id: detect-private-key
-    - id: check-added-large-files
-      args: [--maxkb=500]
-
-- repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.12.5
-  hooks:
-    - id: ruff
-      args:
-        - --fix
-    - id: ruff-format
-      types: [python]
-
-- repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v1.13.0
-  hooks:
-    - id: mypy
-      additional_dependencies: [curl-cffi]

vinted_api_kit-1.0.1/CHANGELOG.md

@@ -1,78 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-
-
-### Changed
-
-
-### Fixed
-
-
-## [1.0.1] - 2026-06-06
-
-### Fixed
-
-- Locale detection now correctly handles multi-part Vinted domains such as `vinted.co.uk` and sets the expected `Accept-Language` header
-- Cookie refresh no longer deletes persisted session cookies before a successful refresh and save completes
-- Runtime exceptions now match the documented public contract for configuration, validation, rate-limit, authentication, and cookie save failures
-
-
-## [1.0.0] - 2026-01-05
-
-### Added
-- Multiple cookie storage backends: `json`, `mozilla`, and `pickle`
-- Dataclass-based models (`CatalogItem`, `DetailedItem`) for performance and clarity
-- Custom exception hierarchy to surface network, auth, and validation errors distinctly
-- Automatic locale detection from target Vinted URLs
-- `SortOrder` and `StorageFormat` type literals for improved typing
-
-### Changed
-- Refactored architecture: separated `api/`, `storage/`, and `models/` layers for better maintainability
-- Default cookie storage format changed to `json` for security hardening
-- SSL verification enabled by default for all HTTP requests
-- Proxy configuration simplified to a single string parameter (`proxy="user:pass@host:port"`)
-- Cookie persistence now uses strategy pattern
-
-### Fixed
-- JWT token expiration parsing (base64url padding handling)
-- Retry/logging behavior for authentication failures
-- Cookie persistence reliability
-- Proxy handling edge cases
-- Token expiration detection accuracy
-
-## [0.1.0.post1] - 2025-08-07
-
-### Fixed
-- Logo display compatibility for PyPI
-- Added project badges to README.md for better presentation
-- Corrected CHANGELOG formatting and metadata
-
-## [0.1.0] - 2025-08-07
-
-### Added
-- Asynchronous HTTP client for Vinted API with cookie management
-- `VintedApi.search_items()` method for item searching with filters
-- `VintedApi.item_details()` method for detailed item information
-- Support for multiple Vinted domains (fr, de, sk, pl, it, etc.)
-- Proxy support for web scraping
-- Automatic authentication and session handling
-- Cookie persistence between requests
-- JWT token expiration detection and refresh
-- Comprehensive error handling with retry logic
-- Full typing support and async/await patterns
-- CI/CD pipeline with GitHub Actions
-- 80%+ test coverage
-
-[Unreleased]: https://github.com/vlymar1/vinted-api-kit/compare/v1.0.1...HEAD
-[1.0.1]: https://github.com/vlymar1/vinted-api-kit/compare/v1.0.0...v1.0.1
-[1.0.0]: https://github.com/vlymar1/vinted-api-kit/compare/v0.1.0...v1.0.0
-[0.1.0.post1]: https://github.com/vlymar1/vinted-api-kit/compare/v0.1.0...v0.1.0.post1
-[0.1.0]: https://github.com/vlymar1/vinted-api-kit/releases/tag/v0.1.0