blocket-api 0.5.1__tar.gz → 0.5.2__tar.gz

{blocket_api-0.5.1 → blocket_api-0.5.2}/PKG-INFO

@@ -1,30 +1,28 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.5.1
+Version: 0.5.2
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: pre-commit>=4.5.1
-Requires-Dist: pytest>=9.0.2
-Requires-Dist: respx>=0.22.0
-Requires-Dist: mypy>=1.19.1
-Requires-Dist: mkdocs>=1.6.1
-Requires-Dist: mkdocs-material>=9.7.1
-Requires-Dist: mkdocs-swagger-ui-tag>=0.7.2
 Requires-Dist: beautifulsoup4>=4.14.3
-Requires-Dist: ruff>=0.15.12
+Provides-Extra: dev
+Requires-Dist: pre-commit>=4.5.1; extra == "dev"
+Requires-Dist: pytest>=9.0.2; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.26.0; extra == "dev"
+Requires-Dist: respx>=0.22.0; extra == "dev"
+Requires-Dist: mypy>=1.19.1; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: flask>=3.1.3; extra == "dev"
+Requires-Dist: htpy>=26.5.1; extra == "dev"
+Requires-Dist: gunicorn>=26.0.0; extra == "dev"
 Dynamic: license-file
 
-<p align="center">
-  <img src="https://blocket-api.se/blocket-api.png" />
-</p>
-
 # BlocketAPI
 
-[![PyPI version](https://img.shields.io/pypi/v/blocket_api?style=for-the-badge)](https://pypi.org/project/blocket_api/) [![License](https://img.shields.io/badge/license-WTFPL-green?style=for-the-badge)](https://github.com/dunderrrrrr/blocket_api/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python-3.10-blue?style=for-the-badge) ![PyPI - Downloads](https://img.shields.io/pypi/dm/blocket_api?style=for-the-badge&color=%23dbce58) 
+[![PyPI version](https://img.shields.io/pypi/v/blocket_api)](https://pypi.org/project/blocket_api/) [![License](https://img.shields.io/badge/license-WTFPL-green)](https://github.com/dunderrrrrr/blocket_api/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python-3.10-blue) ![PyPI - Downloads](https://static.pepy.tech/personalized-badge/blocket-api?period=monthly&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=RED&left_text=downloads%2Fmonth)
 
 BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
 
@@ -35,10 +33,13 @@ BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
 Install BlocketAPI via PyPI...
 
 ```sh
-pip install blocket-api
+pip install blocket-api # using pip
+uv add blocket-api # using uv
 ```
 
-or use [blocket-api.se](https://blocket-api.se) without installing anything!
+## 📜 Docs 
+
+The full documentation can be found at [blocket-api.se](https://blocket-api.se/).
 
 ## 💁‍♀️ Usage
 
@@ -119,6 +120,19 @@ api.get_ad(BoatAd(12345678))
 api.get_ad(McAd(12345678))
 ```
 
+### Async support
+
+```py
+import asyncio
+from blocket_api import AsyncBlocketAPI
+
+async def main():
+    async with AsyncBlocketAPI() as api:
+        results = await api.search("iPhone 15")
+
+asyncio.run(main())
+```
+
 ## 📝 Notes
 
 - REST API: https://blocket-api.se

{blocket_api-0.5.1 → blocket_api-0.5.2}/README.md

@@ -1,10 +1,6 @@
-<p align="center">
-  <img src="https://blocket-api.se/blocket-api.png" />
-</p>
-
 # BlocketAPI
 
-[![PyPI version](https://img.shields.io/pypi/v/blocket_api?style=for-the-badge)](https://pypi.org/project/blocket_api/) [![License](https://img.shields.io/badge/license-WTFPL-green?style=for-the-badge)](https://github.com/dunderrrrrr/blocket_api/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python-3.10-blue?style=for-the-badge) ![PyPI - Downloads](https://img.shields.io/pypi/dm/blocket_api?style=for-the-badge&color=%23dbce58) 
+[![PyPI version](https://img.shields.io/pypi/v/blocket_api)](https://pypi.org/project/blocket_api/) [![License](https://img.shields.io/badge/license-WTFPL-green)](https://github.com/dunderrrrrr/blocket_api/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python-3.10-blue) ![PyPI - Downloads](https://static.pepy.tech/personalized-badge/blocket-api?period=monthly&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=RED&left_text=downloads%2Fmonth)
 
 BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
 
@@ -15,10 +11,13 @@ BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
 Install BlocketAPI via PyPI...
 
 ```sh
-pip install blocket-api
+pip install blocket-api # using pip
+uv add blocket-api # using uv
 ```
 
-or use [blocket-api.se](https://blocket-api.se) without installing anything!
+## 📜 Docs 
+
+The full documentation can be found at [blocket-api.se](https://blocket-api.se/).
 
 ## 💁‍♀️ Usage
 
@@ -99,6 +98,19 @@ api.get_ad(BoatAd(12345678))
 api.get_ad(McAd(12345678))
 ```
 
+### Async support
+
+```py
+import asyncio
+from blocket_api import AsyncBlocketAPI
+
+async def main():
+    async with AsyncBlocketAPI() as api:
+        results = await api.search("iPhone 15")
+
+asyncio.run(main())
+```
+
 ## 📝 Notes
 
 - REST API: https://blocket-api.se

{blocket_api-0.5.1 → blocket_api-0.5.2}/blocket_api/__init__.py

@@ -1,4 +1,5 @@
 from .ad_parser import BoatAd, CarAd, McAd, RecommerceAd
+from .async_blocket import AsyncBlocketAPI
 from .blocket import BlocketAPI, Location
 from .constants import (
     BoatSortOrder,
@@ -17,6 +18,7 @@ from .constants import (
 )
 
 __all__ = [
+    "AsyncBlocketAPI",
     "BlocketAPI",
     "Location",
     "BoatAd",

blocket_api-0.5.2/blocket_api/_params.py

@@ -0,0 +1,166 @@
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from .constants import (
+    BoatType,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    CarWheelDrive,
+    Category,
+    Location,
+    McModel,
+    McSortOrder,
+    McType,
+    SortOrder,
+    SubCategory,
+)
+
+_ParamValue = str | int | float | bool | None
+
+
+def _build_params(
+    defaults: dict[str, _ParamValue],
+    extras: Sequence[tuple[str, _ParamValue]],
+) -> list[tuple[str, _ParamValue]]:
+    params: list[tuple[str, _ParamValue]] = [
+        (k, v) for k, v in defaults.items() if v is not None
+    ]
+    params.extend(extras)
+    return params
+
+
+def build_search_params(
+    query: str,
+    *,
+    page: int = 1,
+    sort_order: SortOrder = SortOrder.RELEVANCE,
+    locations: list[Location] = [],
+    category: Category | None = None,
+    sub_category: SubCategory | None = None,
+) -> list[tuple[str, _ParamValue]]:
+    if category and sub_category:
+        raise AssertionError("Cannot specify both category and sub_categories")
+
+    defaults: dict[str, _ParamValue] = {
+        "q": query,
+        "page": page,
+        "sort": sort_order.value,
+        "category": category.value if category else None,
+        "sub_category": sub_category.value if sub_category else None,
+    }
+
+    extras = [("location", loc.value) for loc in locations]
+
+    return _build_params(defaults, extras)
+
+
+def build_car_params(
+    query: str | None = None,
+    *,
+    page: int = 1,
+    sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
+    locations: list[Location] = [],
+    models: list[CarModel] = [],
+    price_from: int | None = None,
+    price_to: int | None = None,
+    year_from: int | None = None,
+    year_to: int | None = None,
+    milage_from: int | None = None,
+    milage_to: int | None = None,
+    colors: list[CarColor] = [],
+    transmissions: list[CarTransmission] = [],
+    horsepower_from: int | None = None,
+    horsepower_to: int | None = None,
+    wheel_drive: list[CarWheelDrive] = [],
+    org_id: int | None = None,
+) -> list[tuple[str, _ParamValue]]:
+    defaults: dict[str, _ParamValue] = {
+        "q": query,
+        "page": page,
+        "sort": sort_order.value,
+        "price_from": price_from,
+        "price_to": price_to,
+        "year_from": year_from,
+        "year_to": year_to,
+        "milage_from": milage_from,
+        "milage_to": milage_to,
+        "engine_effect_from": horsepower_from,
+        "engine_effect_to": horsepower_to,
+        "orgId": org_id,
+    }
+
+    extras: list[tuple[str, _ParamValue]] = []
+    extras.extend(("location", loc.value) for loc in locations)
+    extras.extend(("make", model.value) for model in models)
+    extras.extend(("exterior_colour", color.value) for color in colors)
+    extras.extend(("transmission", t.value) for t in transmissions)
+    extras.extend(("wheel_drive", w.value) for w in wheel_drive)
+
+    return _build_params(defaults, extras)
+
+
+def build_boat_params(
+    query: str | None = None,
+    *,
+    page: int = 1,
+    sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
+    types: list[BoatType] = [],
+    locations: list[Location] = [],
+    price_from: int | None = None,
+    price_to: int | None = None,
+    length_from: int | None = None,
+    length_to: int | None = None,
+    org_id: int | None = None,
+) -> list[tuple[str, _ParamValue]]:
+    defaults: dict[str, _ParamValue] = {
+        "q": query,
+        "page": page,
+        "sort": sort_order.value,
+        "price_from": price_from,
+        "price_to": price_to,
+        "length_feet_from": length_from,
+        "length_feet_to": length_to,
+        "orgId": org_id,
+    }
+
+    extras: list[tuple[str, _ParamValue]] = []
+    extras.extend(("class", t.value) for t in types)
+    extras.extend(("location", loc.value) for loc in locations)
+
+    return _build_params(defaults, extras)
+
+
+def build_mc_params(
+    query: str | None = None,
+    *,
+    page: int = 1,
+    sort_order: McSortOrder = McSortOrder.RELEVANCE,
+    models: list[McModel] = [],
+    types: list[McType] = [],
+    locations: list[Location] = [],
+    price_from: int | None = None,
+    price_to: int | None = None,
+    engine_volume_from: int | None = None,
+    engine_volume_to: int | None = None,
+    org_id: int | None = None,
+) -> list[tuple[str, _ParamValue]]:
+    defaults: dict[str, _ParamValue] = {
+        "q": query,
+        "page": page,
+        "sort": sort_order.value,
+        "price_from": price_from,
+        "price_to": price_to,
+        "engine_volume_from": engine_volume_from,
+        "engine_volume_to": engine_volume_to,
+        "orgId": org_id,
+    }
+
+    extras: list[tuple[str, _ParamValue]] = []
+    extras.extend(("make", m.value) for m in models)
+    extras.extend(("location", loc.value) for loc in locations)
+    extras.extend(("type", t.value) for t in types)
+
+    return _build_params(defaults, extras)

blocket_api-0.5.2/blocket_api/async_blocket.py

@@ -0,0 +1,187 @@
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from ._params import (
+    build_boat_params,
+    build_car_params,
+    build_mc_params,
+    build_search_params,
+)
+from .ad_parser import BoatAd, CarAd, McAd, RecommerceAd
+from .constants import (
+    BOAT_SEARCH_URL,
+    CAR_SEARCH_URL,
+    HEADERS,
+    MC_SEARCH_URL,
+    SEARCH_URL,
+)
+from .constants import (
+    BoatType,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    CarWheelDrive,
+    Category,
+    Location,
+    McModel,
+    McSortOrder,
+    McType,
+    SortOrder,
+    SubCategory,
+)
+
+
+class AsyncBlocketAPI:
+    def __init__(self, client: httpx.AsyncClient | None = None) -> None:
+        self._client = client or httpx.AsyncClient()
+        self._owns_client = client is None
+
+    async def __aenter__(self) -> AsyncBlocketAPI:
+        return self
+
+    async def __aexit__(self, *_: Any) -> None:
+        await self.aclose()
+
+    async def aclose(self) -> None:
+        await self._client.aclose()
+
+    async def search(
+        self,
+        query: str,
+        *,
+        page: int = 1,
+        sort_order: SortOrder = SortOrder.RELEVANCE,
+        locations: list[Location] = [],
+        category: Category | None = None,
+        sub_category: SubCategory | None = None,
+    ) -> dict[str, Any]:
+        params = build_search_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            locations=locations,
+            category=category,
+            sub_category=sub_category,
+        )
+        response = await self._client.get(SEARCH_URL, headers=HEADERS, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    async def search_car(
+        self,
+        query: str | None = None,
+        *,
+        page: int = 1,
+        sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
+        locations: list[Location] = [],
+        models: list[CarModel] = [],
+        price_from: int | None = None,
+        price_to: int | None = None,
+        year_from: int | None = None,
+        year_to: int | None = None,
+        milage_from: int | None = None,
+        milage_to: int | None = None,
+        colors: list[CarColor] = [],
+        transmissions: list[CarTransmission] = [],
+        horsepower_from: int | None = None,
+        horsepower_to: int | None = None,
+        wheel_drive: list[CarWheelDrive] = [],
+        org_id: int | None = None,
+    ) -> dict[str, Any]:
+        params = build_car_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            locations=locations,
+            models=models,
+            price_from=price_from,
+            price_to=price_to,
+            year_from=year_from,
+            year_to=year_to,
+            milage_from=milage_from,
+            milage_to=milage_to,
+            colors=colors,
+            transmissions=transmissions,
+            horsepower_from=horsepower_from,
+            horsepower_to=horsepower_to,
+            wheel_drive=wheel_drive,
+            org_id=org_id,
+        )
+        response = await self._client.get(
+            CAR_SEARCH_URL, headers=HEADERS, params=params
+        )
+        response.raise_for_status()
+        return response.json()
+
+    async def search_boat(
+        self,
+        query: str | None = None,
+        *,
+        page: int = 1,
+        sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
+        types: list[BoatType] = [],
+        locations: list[Location] = [],
+        price_from: int | None = None,
+        price_to: int | None = None,
+        length_from: int | None = None,
+        length_to: int | None = None,
+        org_id: int | None = None,
+    ) -> Any:
+        params = build_boat_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            types=types,
+            locations=locations,
+            price_from=price_from,
+            price_to=price_to,
+            length_from=length_from,
+            length_to=length_to,
+            org_id=org_id,
+        )
+        response = await self._client.get(
+            BOAT_SEARCH_URL, headers=HEADERS, params=params
+        )
+        response.raise_for_status()
+        return response.json()
+
+    async def search_mc(
+        self,
+        query: str | None = None,
+        *,
+        page: int = 1,
+        sort_order: McSortOrder = McSortOrder.RELEVANCE,
+        models: list[McModel] = [],
+        types: list[McType] = [],
+        locations: list[Location] = [],
+        price_from: int | None = None,
+        price_to: int | None = None,
+        engine_volume_from: int | None = None,
+        engine_volume_to: int | None = None,
+        org_id: int | None = None,
+    ) -> dict[str, Any]:
+        params = build_mc_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            models=models,
+            types=types,
+            locations=locations,
+            price_from=price_from,
+            price_to=price_to,
+            engine_volume_from=engine_volume_from,
+            engine_volume_to=engine_volume_to,
+            org_id=org_id,
+        )
+        response = await self._client.get(MC_SEARCH_URL, headers=HEADERS, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    async def get_ad(self, ad: RecommerceAd | CarAd | BoatAd | McAd) -> dict[str, Any]:
+        response = await self._client.get(ad.url, headers=HEADERS)
+        response.raise_for_status()
+        return ad.parse(response)

blocket_api-0.5.2/blocket_api/blocket.py

@@ -0,0 +1,168 @@
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from ._params import (
+    _ParamValue,
+    build_boat_params,
+    build_car_params,
+    build_mc_params,
+    build_search_params,
+)
+from .ad_parser import BoatAd, CarAd, McAd, RecommerceAd
+from .constants import (
+    BOAT_SEARCH_URL,
+    CAR_SEARCH_URL,
+    HEADERS,
+    MC_SEARCH_URL,
+    SEARCH_URL,
+)
+from .constants import (
+    BoatType,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    CarWheelDrive,
+    Category,
+    Location,
+    McModel,
+    McSortOrder,
+    McType,
+    SortOrder,
+    SubCategory,
+)
+
+
+def _request(*, url: str, params: list[tuple[str, _ParamValue]]) -> httpx.Response:
+    response = httpx.get(url, headers=HEADERS, params=params)
+    response.raise_for_status()
+    return response
+
+
+class BlocketAPI:
+    def search(
+        self,
+        query: str,
+        *,
+        page: int = 1,
+        sort_order: SortOrder = SortOrder.RELEVANCE,
+        locations: list[Location] = [],
+        category: Category | None = None,
+        sub_category: SubCategory | None = None,
+    ) -> dict[str, Any]:
+        params = build_search_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            locations=locations,
+            category=category,
+            sub_category=sub_category,
+        )
+        return _request(url=SEARCH_URL, params=params).json()
+
+    def search_car(
+        self,
+        query: str | None = None,
+        *,
+        page: int = 1,
+        sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
+        locations: list[Location] = [],
+        models: list[CarModel] = [],
+        price_from: int | None = None,
+        price_to: int | None = None,
+        year_from: int | None = None,
+        year_to: int | None = None,
+        milage_from: int | None = None,
+        milage_to: int | None = None,
+        colors: list[CarColor] = [],
+        transmissions: list[CarTransmission] = [],
+        horsepower_from: int | None = None,
+        horsepower_to: int | None = None,
+        wheel_drive: list[CarWheelDrive] = [],
+        org_id: int | None = None,
+    ) -> dict[str, Any]:
+        params = build_car_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            locations=locations,
+            models=models,
+            price_from=price_from,
+            price_to=price_to,
+            year_from=year_from,
+            year_to=year_to,
+            milage_from=milage_from,
+            milage_to=milage_to,
+            colors=colors,
+            transmissions=transmissions,
+            horsepower_from=horsepower_from,
+            horsepower_to=horsepower_to,
+            wheel_drive=wheel_drive,
+            org_id=org_id,
+        )
+        return _request(url=CAR_SEARCH_URL, params=params).json()
+
+    def search_boat(
+        self,
+        query: str | None = None,
+        *,
+        page: int = 1,
+        sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
+        types: list[BoatType] = [],
+        locations: list[Location] = [],
+        price_from: int | None = None,
+        price_to: int | None = None,
+        length_from: int | None = None,
+        length_to: int | None = None,
+        org_id: int | None = None,
+    ) -> Any:
+        params = build_boat_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            types=types,
+            locations=locations,
+            price_from=price_from,
+            price_to=price_to,
+            length_from=length_from,
+            length_to=length_to,
+            org_id=org_id,
+        )
+        return _request(url=BOAT_SEARCH_URL, params=params).json()
+
+    def search_mc(
+        self,
+        query: str | None = None,
+        *,
+        page: int = 1,
+        sort_order: McSortOrder = McSortOrder.RELEVANCE,
+        models: list[McModel] = [],
+        types: list[McType] = [],
+        locations: list[Location] = [],
+        price_from: int | None = None,
+        price_to: int | None = None,
+        engine_volume_from: int | None = None,
+        engine_volume_to: int | None = None,
+        org_id: int | None = None,
+    ) -> dict[str, Any]:
+        params = build_mc_params(
+            query,
+            page=page,
+            sort_order=sort_order,
+            models=models,
+            types=types,
+            locations=locations,
+            price_from=price_from,
+            price_to=price_to,
+            engine_volume_from=engine_volume_from,
+            engine_volume_to=engine_volume_to,
+            org_id=org_id,
+        )
+        return _request(url=MC_SEARCH_URL, params=params).json()
+
+    def get_ad(self, ad: RecommerceAd | CarAd | BoatAd | McAd) -> dict[str, Any]:
+        response = _request(url=ad.url, params=[])
+        return ad.parse(response)

{blocket_api-0.5.1 → blocket_api-0.5.2}/blocket_api/constants.py

@@ -1,6 +1,11 @@
 from enum import IntEnum, StrEnum
 
 SITE_URL = "https://www.blocket.se"
+SEARCH_URL = f"{SITE_URL}/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON"
+CAR_SEARCH_URL = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_CAR_USED"
+BOAT_SEARCH_URL = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_BOAT_USED"
+MC_SEARCH_URL = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_MC_USED"
+
 HEADERS = {
     "User-Agent": "Mozilla/5.0 (X11; Linux x86_64; rv:128.0) Gecko/20100101 Firefox/128.0"
 }

{blocket_api-0.5.1 → blocket_api-0.5.2}/blocket_api.egg-info/PKG-INFO

@@ -1,30 +1,28 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.5.1
+Version: 0.5.2
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: pre-commit>=4.5.1
-Requires-Dist: pytest>=9.0.2
-Requires-Dist: respx>=0.22.0
-Requires-Dist: mypy>=1.19.1
-Requires-Dist: mkdocs>=1.6.1
-Requires-Dist: mkdocs-material>=9.7.1
-Requires-Dist: mkdocs-swagger-ui-tag>=0.7.2
 Requires-Dist: beautifulsoup4>=4.14.3
-Requires-Dist: ruff>=0.15.12
+Provides-Extra: dev
+Requires-Dist: pre-commit>=4.5.1; extra == "dev"
+Requires-Dist: pytest>=9.0.2; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.26.0; extra == "dev"
+Requires-Dist: respx>=0.22.0; extra == "dev"
+Requires-Dist: mypy>=1.19.1; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: flask>=3.1.3; extra == "dev"
+Requires-Dist: htpy>=26.5.1; extra == "dev"
+Requires-Dist: gunicorn>=26.0.0; extra == "dev"
 Dynamic: license-file
 
-<p align="center">
-  <img src="https://blocket-api.se/blocket-api.png" />
-</p>
-
 # BlocketAPI
 
-[![PyPI version](https://img.shields.io/pypi/v/blocket_api?style=for-the-badge)](https://pypi.org/project/blocket_api/) [![License](https://img.shields.io/badge/license-WTFPL-green?style=for-the-badge)](https://github.com/dunderrrrrr/blocket_api/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python-3.10-blue?style=for-the-badge) ![PyPI - Downloads](https://img.shields.io/pypi/dm/blocket_api?style=for-the-badge&color=%23dbce58) 
+[![PyPI version](https://img.shields.io/pypi/v/blocket_api)](https://pypi.org/project/blocket_api/) [![License](https://img.shields.io/badge/license-WTFPL-green)](https://github.com/dunderrrrrr/blocket_api/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python-3.10-blue) ![PyPI - Downloads](https://static.pepy.tech/personalized-badge/blocket-api?period=monthly&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=RED&left_text=downloads%2Fmonth)
 
 BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
 
@@ -35,10 +33,13 @@ BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
 Install BlocketAPI via PyPI...
 
 ```sh
-pip install blocket-api
+pip install blocket-api # using pip
+uv add blocket-api # using uv
 ```
 
-or use [blocket-api.se](https://blocket-api.se) without installing anything!
+## 📜 Docs 
+
+The full documentation can be found at [blocket-api.se](https://blocket-api.se/).
 
 ## 💁‍♀️ Usage
 
@@ -119,6 +120,19 @@ api.get_ad(BoatAd(12345678))
 api.get_ad(McAd(12345678))
 ```
 
+### Async support
+
+```py
+import asyncio
+from blocket_api import AsyncBlocketAPI
+
+async def main():
+    async with AsyncBlocketAPI() as api:
+        results = await api.search("iPhone 15")
+
+asyncio.run(main())
+```
+
 ## 📝 Notes
 
 - REST API: https://blocket-api.se

{blocket_api-0.5.1 → blocket_api-0.5.2}/blocket_api.egg-info/SOURCES.txt

@@ -2,7 +2,9 @@ LICENSE
 README.md
 pyproject.toml
 blocket_api/__init__.py
+blocket_api/_params.py
 blocket_api/ad_parser.py
+blocket_api/async_blocket.py
 blocket_api/blocket.py
 blocket_api/constants.py
 blocket_api.egg-info/PKG-INFO

{blocket_api-0.5.1 → blocket_api-0.5.2}/blocket_api.egg-info/requires.txt

@@ -1,10 +1,13 @@
 httpx>=0.28.1
+beautifulsoup4>=4.14.3
+
+[dev]
 pre-commit>=4.5.1
 pytest>=9.0.2
+pytest-asyncio>=0.26.0
 respx>=0.22.0
 mypy>=1.19.1
-mkdocs>=1.6.1
-mkdocs-material>=9.7.1
-mkdocs-swagger-ui-tag>=0.7.2
-beautifulsoup4>=4.14.3
-ruff>=0.15.12
+ruff>=0.9.0
+flask>=3.1.3
+htpy>=26.5.1
+gunicorn>=26.0.0

{blocket_api-0.5.1 → blocket_api-0.5.2}/pyproject.toml

@@ -1,21 +1,26 @@
 [project]
 name = "blocket_api"
-version = "0.5.1"
+version = "0.5.2"
 description = "A python API wrapper for blocket.se"
 authors = [{name = "dunderrrrrr", email = "emil.bjorkroth@gmail.com"}]
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "httpx>=0.28.1",
+    "beautifulsoup4>=4.14.3",
+]
+
+[project.optional-dependencies]
+dev = [
     "pre-commit>=4.5.1",
     "pytest>=9.0.2",
+    "pytest-asyncio>=0.26.0",
     "respx>=0.22.0",
     "mypy>=1.19.1",
-    "mkdocs>=1.6.1",
-    "mkdocs-material>=9.7.1",
-    "mkdocs-swagger-ui-tag>=0.7.2",
-    "beautifulsoup4>=4.14.3",
-    "ruff>=0.15.12",
+    "ruff>=0.9.0",
+    "flask>=3.1.3",
+    "htpy>=26.5.1",
+    "gunicorn>=26.0.0",
 ]
 
 
@@ -23,3 +28,4 @@ dependencies = [
 testpaths = [
     "tests/*",
 ]
+asyncio_mode = "auto"

blocket_api-0.5.1/blocket_api/blocket.py

@@ -1,196 +0,0 @@
-from __future__ import annotations
-
-from dataclasses import dataclass
-from typing import Any
-
-import httpx
-from httpx import Response
-
-from .ad_parser import BoatAd, CarAd, McAd, RecommerceAd
-from .constants import (
-    HEADERS,
-    SITE_URL,
-    BoatType,
-    CarColor,
-    CarModel,
-    CarSortOrder,
-    CarTransmission,
-    CarWheelDrive,
-    Category,
-    Location,
-    McModel,
-    McSortOrder,
-    McType,
-    SortOrder,
-    SubCategory,
-)
-
-
-@dataclass(frozen=True)
-class QueryParam:
-    name: str
-    value: str | int
-
-
-def _request(*, url: str, params: list[QueryParam]) -> Response:
-    response = httpx.get(
-        url,
-        headers=HEADERS,
-        params=[(param.name, param.value) for param in params],
-    )
-    response.raise_for_status()
-    return response
-
-
-@dataclass(frozen=True)
-class BlocketAPI:
-    def search(
-        self,
-        query: str,
-        *,
-        page: int = 1,
-        sort_order: SortOrder = SortOrder.RELEVANCE,
-        locations: list[Location] = [],
-        category: Category | None = None,
-        sub_category: SubCategory | None = None,
-    ) -> dict[str, Any]:
-        if category and sub_category:
-            raise AssertionError("Cannot specify both category and sub_categories")
-
-        url = f"{SITE_URL}/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON"
-
-        param_dict: dict[str, str | int | None] = {
-            "q": query,
-            "page": page,
-            "sort": sort_order.value,
-            "category": category.value if category else None,
-            "sub_category": sub_category.value if sub_category else None,
-        }
-
-        params = [QueryParam(k, v) for k, v in param_dict.items() if v is not None]
-
-        params.extend(QueryParam("location", loc.value) for loc in locations)
-
-        return _request(url=url, params=params).json()
-
-    def search_car(
-        self,
-        query: str | None = None,
-        *,
-        page: int = 1,
-        sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
-        locations: list[Location] = [],
-        models: list[CarModel] = [],
-        price_from: int | None = None,
-        price_to: int | None = None,
-        year_from: int | None = None,
-        year_to: int | None = None,
-        milage_from: int | None = None,
-        milage_to: int | None = None,
-        colors: list[CarColor] = [],
-        transmissions: list[CarTransmission] = [],
-        horsepower_from: int | None = None,
-        horsepower_to: int | None = None,
-        wheel_drive: list[CarWheelDrive] = [],
-        org_id: int | None = None,
-    ) -> dict[str, Any]:
-        url = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_CAR_USED"
-
-        param_dict: dict[str, str | int | None] = {
-            "q": query,
-            "page": page,
-            "sort": sort_order.value,
-            "price_from": price_from,
-            "price_to": price_to,
-            "year_from": year_from,
-            "year_to": year_to,
-            "milage_from": milage_from,
-            "milage_to": milage_to,
-            "engine_effect_from": horsepower_from,
-            "engine_effect_to": horsepower_to,
-            "orgId": org_id,
-        }
-
-        params = [QueryParam(k, v) for k, v in param_dict.items() if v is not None]
-
-        params.extend(QueryParam("location", loc.value) for loc in locations)
-        params.extend(QueryParam("make", model.value) for model in models)
-        params.extend(QueryParam("exterior_colour", color.value) for color in colors)
-        params.extend(QueryParam("transmission", t.value) for t in transmissions)
-        params.extend(QueryParam("wheel_drive", w.value) for w in wheel_drive)
-
-        return _request(url=url, params=params).json()
-
-    def search_boat(
-        self,
-        query: str | None = None,
-        *,
-        page: int = 1,
-        sort_order: CarSortOrder = CarSortOrder.RELEVANCE,
-        types: list[BoatType] = [],
-        locations: list[Location] = [],
-        price_from: int | None = None,
-        price_to: int | None = None,
-        length_from: int | None = None,
-        length_to: int | None = None,
-        org_id: int | None = None,
-    ) -> Any:
-        url = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_BOAT_USED"
-
-        param_dict: dict[str, str | int | None] = {
-            "q": query,
-            "page": page,
-            "sort": sort_order.value,
-            "price_from": price_from,
-            "price_to": price_to,
-            "length_feet_from": length_from,
-            "length_feet_to": length_to,
-            "orgId": org_id,
-        }
-
-        params = [QueryParam(k, v) for k, v in param_dict.items() if v is not None]
-
-        params.extend(QueryParam("class", t.value) for t in types)
-        params.extend(QueryParam("location", loc.value) for loc in locations)
-
-        return _request(url=url, params=params).json()
-
-    def search_mc(
-        self,
-        query: str | None = None,
-        *,
-        page: int = 1,
-        sort_order: McSortOrder = McSortOrder.RELEVANCE,
-        models: list[McModel] = [],
-        types: list[McType] = [],
-        locations: list[Location] = [],
-        price_from: int | None = None,
-        price_to: int | None = None,
-        engine_volume_from: int | None = None,
-        engine_volume_to: int | None = None,
-        org_id: int | None = None,
-    ) -> dict[str, Any]:
-        url = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_MC_USED"
-
-        param_dict: dict[str, str | int | None] = {
-            "q": query,
-            "page": page,
-            "sort": sort_order.value,
-            "price_from": price_from,
-            "price_to": price_to,
-            "engine_volume_from": engine_volume_from,
-            "engine_volume_to": engine_volume_to,
-            "orgId": org_id,
-        }
-
-        params = [QueryParam(k, v) for k, v in param_dict.items() if v is not None]
-
-        params.extend(QueryParam("make", m.value) for m in models)
-        params.extend(QueryParam("location", loc.value) for loc in locations)
-        params.extend(QueryParam("type", t.value) for t in types)
-
-        return _request(url=url, params=params).json()
-
-    def get_ad(self, ad: RecommerceAd | CarAd | BoatAd | McAd) -> dict[str, Any]:
-        response = _request(url=ad.url, params=[])
-        return ad.parse(response)