blocket-api 0.3.7__tar.gz → 0.3.9__tar.gz

blocket_api-0.3.9/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: blocket_api
+Version: 0.3.9
+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>=3.7.1
+Requires-Dist: pytest>=8.2.2
+Requires-Dist: respx>=0.21.1
+Requires-Dist: mypy>=1.15.0
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: mkdocs>=1.6.1
+Requires-Dist: mkdocs-material>=9.6.21
+Requires-Dist: mkdocs-swagger-ui-tag>=0.7.2
+Requires-Dist: websockets>=15.0.1
+Requires-Dist: ruff>=0.14.5
+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/dw/blocket_api?style=for-the-badge&color=%23dbce58) 
+
+BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
+
+> Blocket is one of Sweden's largest online marketplaces. It was founded in 1996 and allows users to buy and sell a wide range of items, including cars, real estate, jobs, services, and second-hand goods. The platform is known for its extensive reach and user-friendly interface, making it a popular choice for Swedes looking to purchase or sell items quickly and efficiently.
+
+> [!NOTE]  
+> Blocket recently released a new version of their site which caused this package to break. But do not fear, we are actively working to try and restore all functionality. More info in [issue #43](https://github.com/dunderrrrrr/blocket_api/issues/41).
+
+## 🧑‍💻️ Install
+
+Install BlocketAPI via PyPI...
+
+```sh
+pip install blocket-api
+```
+
+or use [blocket-api.se](https://blocket-api.se) without installing anything!
+
+## 💁‍♀️ Usage
+
+```py
+from blocket_api import BlocketAPI, Category, Location, SortOrder
+
+api = BlocketAPI()
+
+result = api.search(
+    "Vinterdäck Audi",
+    sort_order=SortOrder.PRICE_ASC,
+    locations=[Location.STOCKHOLM, Location.UPPSALA],
+    category=Category.FORDONSTILLBEHOR,
+)
+```
+
+## 📝 Notes
+
+- REST API: https://blocket-api.se
+- Source repo: https://github.com/dunderrrrrr/blocket_api
+- PyPI: https://pypi.org/project/blocket-api/

blocket_api-0.3.9/README.md

@@ -0,0 +1,45 @@
+<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/dw/blocket_api?style=for-the-badge&color=%23dbce58) 
+
+BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
+
+> Blocket is one of Sweden's largest online marketplaces. It was founded in 1996 and allows users to buy and sell a wide range of items, including cars, real estate, jobs, services, and second-hand goods. The platform is known for its extensive reach and user-friendly interface, making it a popular choice for Swedes looking to purchase or sell items quickly and efficiently.
+
+> [!NOTE]  
+> Blocket recently released a new version of their site which caused this package to break. But do not fear, we are actively working to try and restore all functionality. More info in [issue #43](https://github.com/dunderrrrrr/blocket_api/issues/41).
+
+## 🧑‍💻️ Install
+
+Install BlocketAPI via PyPI...
+
+```sh
+pip install blocket-api
+```
+
+or use [blocket-api.se](https://blocket-api.se) without installing anything!
+
+## 💁‍♀️ Usage
+
+```py
+from blocket_api import BlocketAPI, Category, Location, SortOrder
+
+api = BlocketAPI()
+
+result = api.search(
+    "Vinterdäck Audi",
+    sort_order=SortOrder.PRICE_ASC,
+    locations=[Location.STOCKHOLM, Location.UPPSALA],
+    category=Category.FORDONSTILLBEHOR,
+)
+```
+
+## 📝 Notes
+
+- REST API: https://blocket-api.se
+- Source repo: https://github.com/dunderrrrrr/blocket_api
+- PyPI: https://pypi.org/project/blocket-api/

blocket_api-0.3.9/blocket_api/__init__.py

@@ -0,0 +1,5 @@
+from .blocket import BlocketAPI as BlocketAPI
+from .blocket import Location as Location
+from .constants import Category as Category
+from .constants import SortOrder as SortOrder
+from .constants import SubCategory as SubCategory

blocket_api-0.3.9/blocket_api/blocket.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+import httpx
+
+from .constants import HEADERS, SITE_URL, Category, Location, SortOrder, SubCategory
+
+
+@dataclass(frozen=True)
+class QueryParam:
+    name: str
+    value: str
+
+
+def _request(
+    *,
+    url: str,
+    params: list[QueryParam],
+) -> Any:
+    response = httpx.get(
+        url,
+        headers=HEADERS,
+        params=[(param.name, param.value) for param in params],
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+@dataclass(frozen=True)
+class BlocketAPI:
+    def search(
+        self,
+        query: str,
+        *,
+        sort_order: SortOrder = SortOrder.RELEVANCE,
+        locations: list[Location] = [],
+        category: Category | None = None,
+        sub_category: SubCategory | None = None,
+    ) -> Any:
+        if category and sub_category:
+            raise AssertionError("Cannot specify both category and sub_categories")
+
+        url = f"{SITE_URL}/recommerce-search-page/api/search/SEARCH_ID_BAP_COMMON"
+        params = [
+            QueryParam("q", query),
+            QueryParam("sort", sort_order.value),
+            *[QueryParam("location", location.value) for location in locations],
+            *([QueryParam("category", category.value)] if category else []),
+            *([QueryParam("sub_category", sub_category.value)] if sub_category else []),
+        ]
+
+        return _request(url=url, params=params)

blocket_api-0.3.9/blocket_api/constants.py

@@ -0,0 +1,107 @@
+from enum import StrEnum
+
+SITE_URL = "https://www.blocket.se"
+HEADERS = {
+    "User-Agent": "Mozilla/5.0 (X11; Linux x86_64; rv:128.0) Gecko/20100101 Firefox/128.0"
+}
+
+
+class SortOrder(StrEnum):
+    RELEVANCE = "RELEVANCE"
+    PRICE_DESC = "PRICE_DESC"
+    PRICE_ASC = "PRICE_ASC"
+    PUBLISHED_DESC = "PUBLISHED_DESC"
+    PUBLISHED_ASC = "PUBLISHED_ASC"
+
+
+class Location(StrEnum):
+    BLEKINGE = "0.300010"
+    DALARNA = "0.300020"
+    GOTLAND = "0.300009"
+    GAVLEBORG = "0.300021"
+    HALLAND = "0.300013"
+    JAMTLAND = "0.300023"
+    JONKOPING = "0.300006"
+    KALMAR = "0.300008"
+    KRONOBERG = "0.300007"
+    NORRBOTTEN = "0.300025"
+    SKANE = "0.300012"
+    STOCKHOLM = "0.300001"
+    SODERMANLAND = "0.300004"
+    UPPSALA = "0.300003"
+    VARMLAND = "0.300017"
+    VASTERBOTTEN = "0.300024"
+    VASTERNORRLAND = "0.300022"
+    VASTMANLAND = "0.300019"
+    VASTRA_GÖTALAND = "0.300014"
+    OREBRO = "0.300018"
+    OSTERGOTLAND = "0.300005"
+
+
+class Category(StrEnum):
+    AFFARSVERKSAMHET = "0.91"
+    # BIL_OCH_HUSVAGN = None
+    # BAT = None
+    DJUR_OCH_TILLBEHOR = "0.77"
+    ELEKTRONIK_OCH_VITVAROR = "0.93"
+    # ENTREPRENAD__OCH_LANTBRUKSMASKINER = None
+    FORDONSTILLBEHOR = "0.90"
+    FRITID_HOBBY_OCH_UNDERHALLNING = "0.86"
+    FORALDRAR_OCH_BARN = "0.68"
+    KLADER_KOSMETIKA_OCH_ACCESSOARER = "0.71"
+    KONST_OCH_ANTIKT = "0.76"
+    # MOTORCYKLAR = None
+    MOBLER_OCH_INREDNING = "0.78"
+    SPORT_OCH_FRITID = "0.69"
+    TRADGARD_OCH_RENOVERING = "0.67"
+
+
+class SubCategory(StrEnum):
+    BYGGMATERIAL_OCH_RENOVERING = "1.67.3899"
+    BILDELAR_OCH_TILLBEHOR = "1.90.82"
+    CYKEL = "1.69.3963"
+    JAKT_FISKE_OCH_CAMPING = "1.69.3964"
+    TRADGARD_OCH_UTEMILJO = "1.67.3901"
+    MC_UTRUSTNING_OCH_RESERVDELAR = "1.90.20"
+    HUSVAGNS_OCH_HUSBILSDELAR = "1.90.70"
+    VERKTYG = "1.67.5219"
+    BUTIK_OCH_DETALJHANDEL = "1.91.3108"
+    CONTAINRAR_OCH_BARACKER = "1.91.3111"
+    DOMANER_OCH_SAJTER = "1.91.3106"
+    HALSA_OCH_FORSTA_HJALPEN = "1.91.8343"
+    JORDBRUK = "1.91.3114"
+    KONTORSUTRUSTNING_OCH_INREDNING = "1.91.3105"
+    LAST_OCH_TRANSPORT = "1.91.3113"
+    MASKINUTRUSTNING_OCH_RESERVDELAR = "1.91.3112"
+    SCEN = "1.91.3110"
+    STORKOK_OCH_RESTAURANG = "1.91.3103"
+    VERKSTAD_BYGG_OCH_KONSTRUKTION = "1.91.3102"
+    SLAP_OCH_TRAILER = "1.90.80"
+    BATDELAR_OCH_TILLBEHOR = "1.90.30"
+    AKVARIUM = "1.77.3976"
+    BURAR = "1.77.3977"
+    FISKAR = "1.77.5206"
+    FODER_DJURVARD_KENNLAR_OCH_STALL = "1.77.5186"
+    FAGLAR = "1.77.5205"
+    GNAGARE_OCH_KANINER = "1.77.5207"
+    HUNDAR = "1.77.5192"
+    HUNDTILLBEHOR = "1.77.5193"
+    HAST_OCH_RIDUTRUSTNING = "1.77.5195"
+    HASTAR = "1.77.5190"
+    KATTER = "1.77.5191"
+    KATTILLBEHOR = "1.77.5194"
+    LANTBRUKSDJUR = "1.77.9439"
+    REPTILER = "1.77.5210"
+    SPINDLAR_OCH_INSEKTER = "1.77.5208"
+    OVRIGA_DJUR = "1.77.5183"
+    OVRIGA_DJURTILLBEHOR = "1.77.5185"
+    DATORER = "1.93.3215"
+    FOTO_OCH_VIDEO = "1.93.3904"
+    HUSHALLSAPPARATER = "1.93.3216"
+    LJUD_OCH_BILD = "1.93.3906"
+    PERSONVARD = "1.93.9809"
+    TELEFONER_OCH_TILLBEHOR = "1.93.3217"
+    TV_SPEL_OCH_SPELKONSOLER = "1.93.3905"
+    VITVAROR = "1.93.3907"
+    ATV_RESERVDELAR = "1.90.3975"
+    OVRIGT = "1.90.3974"

blocket_api-0.3.9/blocket_api.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: blocket_api
+Version: 0.3.9
+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>=3.7.1
+Requires-Dist: pytest>=8.2.2
+Requires-Dist: respx>=0.21.1
+Requires-Dist: mypy>=1.15.0
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: mkdocs>=1.6.1
+Requires-Dist: mkdocs-material>=9.6.21
+Requires-Dist: mkdocs-swagger-ui-tag>=0.7.2
+Requires-Dist: websockets>=15.0.1
+Requires-Dist: ruff>=0.14.5
+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/dw/blocket_api?style=for-the-badge&color=%23dbce58) 
+
+BlocketAPI allows users to search [blocket.se](https://blocket.se/) for ads.
+
+> Blocket is one of Sweden's largest online marketplaces. It was founded in 1996 and allows users to buy and sell a wide range of items, including cars, real estate, jobs, services, and second-hand goods. The platform is known for its extensive reach and user-friendly interface, making it a popular choice for Swedes looking to purchase or sell items quickly and efficiently.
+
+> [!NOTE]  
+> Blocket recently released a new version of their site which caused this package to break. But do not fear, we are actively working to try and restore all functionality. More info in [issue #43](https://github.com/dunderrrrrr/blocket_api/issues/41).
+
+## 🧑‍💻️ Install
+
+Install BlocketAPI via PyPI...
+
+```sh
+pip install blocket-api
+```
+
+or use [blocket-api.se](https://blocket-api.se) without installing anything!
+
+## 💁‍♀️ Usage
+
+```py
+from blocket_api import BlocketAPI, Category, Location, SortOrder
+
+api = BlocketAPI()
+
+result = api.search(
+    "Vinterdäck Audi",
+    sort_order=SortOrder.PRICE_ASC,
+    locations=[Location.STOCKHOLM, Location.UPPSALA],
+    category=Category.FORDONSTILLBEHOR,
+)
+```
+
+## 📝 Notes
+
+- REST API: https://blocket-api.se
+- Source repo: https://github.com/dunderrrrrr/blocket_api
+- PyPI: https://pypi.org/project/blocket-api/

{blocket_api-0.3.7 → blocket_api-0.3.9}/blocket_api.egg-info/SOURCES.txt

@@ -4,10 +4,6 @@ pyproject.toml
 blocket_api/__init__.py
 blocket_api/blocket.py
 blocket_api/constants.py
-blocket_api/decorators.py
-blocket_api/models.py
-blocket_api/qasa.py
-blocket_api/sendbird.py
 blocket_api.egg-info/PKG-INFO
 blocket_api.egg-info/SOURCES.txt
 blocket_api.egg-info/dependency_links.txt

{blocket_api-0.3.7 → blocket_api-0.3.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "blocket_api"
-version = "0.3.7"
+version = "0.3.9"
 description = "A python API wrapper for blocket.se"
 authors = [{name = "dunderrrrrr", email = "emil.bjorkroth@gmail.com"}]
 readme = "README.md"