blocket-api 0.2.7__tar.gz → 0.2.8__tar.gz

{blocket_api-0.2.7 → blocket_api-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.2.7
+Version: 0.2.8
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
@@ -11,7 +11,7 @@ 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: ruff>=0.12.3
+Requires-Dist: ruff>=0.12.4
 Dynamic: license-file
 
 # BlocketAPI
@@ -27,9 +27,9 @@ BlocketAPI allows users to query saved searches, known as "Bevakningar", on [blo
 - List saved searches, called "Bevakningar".
 - Get listings from all or a specific saved search.
 - Search for anything on Blocket with filters for region and category.
-- Advanced search for vehicles with multiple filters.
-- Get vehicle information and price evaluation.
+- Get vehicle information, price evaluation and search for vehicles with multiple filters.
 - Search for homes with filters for city, home type and more.
+- Search for stores and get a specific store's listings.
 
 ## 🧑‍💻️ Install
 
@@ -50,7 +50,7 @@ pip install blocket-api
 ...
 ```
 
-Some calls require a bearerToken. However, some calls are public and don't require a token.
+Some calls require a `bearerToken`. However, some calls are public and don't require a token.
 
 [Where token?](#-blocket-api-token)
 
@@ -63,6 +63,8 @@ Some calls require a bearerToken. However, some calls are public and don't requi
 | [`api.motor_search()`](#motor_searchpage-make-fuel-chassi-price-modelyear-milage-gearbox)  | 👏 No | Advanced search for car-listings. |
 | [`api.price_eval()`](#price_evalregistration_number)  | 👏 No | Vehicle purchase valuation and details. | 
 | [`api.home_search()`](#home_searchcity-type-order_by-ordering-offset)  | 👏 No | Query home listings.
+| [`api.store_search()`](#store_searchsearch_query-page)  | 👏 No | Search for a store.
+| [`api.get_store_listings()`](#get_store_listingsstore_id-page)  | 👏 No | Get listings from a specific store.
 
 ## 🤓 Detailed usage
 
@@ -221,6 +223,48 @@ Query home listings from [bostad.blocket.se](https://bostad.blocket.se/).
 ...
 ```
 
+### store_search(search_query, page)
+Search for a store in Blocket stores from [blocket.se/butiker](https://www.blocket.se/butiker).
+
+- `search_query` (`str`, required) - The name of the store. 
+- `page` (`int`, optional) - The page number to return.
+
+```py
+>>> api.store_search("Jannes Car and Kebab")
+{
+  "data": [
+    {
+      "store_id": "1234",
+      "store_name": "Jannes Car and Kebab",
+      ...
+    },
+    ...
+  ]
+}
+```
+
+### get_store_listings(store_id, page)
+Get listings from a specific store.
+
+- `store_id` (`int`, required) - The store id. Can be obtained by calling `store_search()`.
+- `page` (`int`, optional) - The page number to return.
+
+```py
+>>> api.get_store_listings(1234)
+{
+  "data": [
+    {
+      "ad_id": "1234",
+      "price": 316000,
+      "body": "A very nice car.",
+      "images": [],
+      ...
+    },
+    ...
+  ]
+}
+```
+
 ## 🔐 Blocket API token
 
 There are two ways to acquire your token:

{blocket_api-0.2.7 → blocket_api-0.2.8}/README.md

@@ -11,9 +11,9 @@ BlocketAPI allows users to query saved searches, known as "Bevakningar", on [blo
 - List saved searches, called "Bevakningar".
 - Get listings from all or a specific saved search.
 - Search for anything on Blocket with filters for region and category.
-- Advanced search for vehicles with multiple filters.
-- Get vehicle information and price evaluation.
+- Get vehicle information, price evaluation and search for vehicles with multiple filters.
 - Search for homes with filters for city, home type and more.
+- Search for stores and get a specific store's listings.
 
 ## 🧑‍💻️ Install
 
@@ -34,7 +34,7 @@ pip install blocket-api
 ...
 ```
 
-Some calls require a bearerToken. However, some calls are public and don't require a token.
+Some calls require a `bearerToken`. However, some calls are public and don't require a token.
 
 [Where token?](#-blocket-api-token)
 
@@ -47,6 +47,8 @@ Some calls require a bearerToken. However, some calls are public and don't requi
 | [`api.motor_search()`](#motor_searchpage-make-fuel-chassi-price-modelyear-milage-gearbox)  | 👏 No | Advanced search for car-listings. |
 | [`api.price_eval()`](#price_evalregistration_number)  | 👏 No | Vehicle purchase valuation and details. | 
 | [`api.home_search()`](#home_searchcity-type-order_by-ordering-offset)  | 👏 No | Query home listings.
+| [`api.store_search()`](#store_searchsearch_query-page)  | 👏 No | Search for a store.
+| [`api.get_store_listings()`](#get_store_listingsstore_id-page)  | 👏 No | Get listings from a specific store.
 
 ## 🤓 Detailed usage
 
@@ -205,6 +207,48 @@ Query home listings from [bostad.blocket.se](https://bostad.blocket.se/).
 ...
 ```
 
+### store_search(search_query, page)
+Search for a store in Blocket stores from [blocket.se/butiker](https://www.blocket.se/butiker).
+
+- `search_query` (`str`, required) - The name of the store. 
+- `page` (`int`, optional) - The page number to return.
+
+```py
+>>> api.store_search("Jannes Car and Kebab")
+{
+  "data": [
+    {
+      "store_id": "1234",
+      "store_name": "Jannes Car and Kebab",
+      ...
+    },
+    ...
+  ]
+}
+```
+
+### get_store_listings(store_id, page)
+Get listings from a specific store.
+
+- `store_id` (`int`, required) - The store id. Can be obtained by calling `store_search()`.
+- `page` (`int`, optional) - The page number to return.
+
+```py
+>>> api.get_store_listings(1234)
+{
+  "data": [
+    {
+      "ad_id": "1234",
+      "price": 316000,
+      "body": "A very nice car.",
+      "images": [],
+      ...
+    },
+    ...
+  ]
+}
+```
+
 ## 🔐 Blocket API token
 
 There are two ways to acquire your token:

{blocket_api-0.2.7 → blocket_api-0.2.8}/blocket_api/blocket.py

@@ -334,3 +334,32 @@ class BlocketAPI:
             ordering=ordering,
             offset=offset,
         ).search()
+
+    @public_token
+    def search_store(
+        self,
+        search_query: str,
+        page: int = 0,
+    ) -> dict:
+        """
+        Searching through Blocket stores from https://www.blocket.se/butiker.
+        The store_id is used for get_store_listings().
+        """
+        url = f"{BASE_URL}/search_bff/v1/stores?q={search_query}&page={page}"
+        return _make_request(url=f"{url}", token=self.token).json()
+
+    @public_token
+    def get_store_listings(
+        self,
+        store_id: int,
+        page: int = 0,
+    ) -> dict:
+        """
+        Return all listings from a specific store from https://www.blocket.se/butik/<store>.
+        The store_id can be found by searching for the store with search_store().
+        """
+        url = (
+            f"{BASE_URL}/search_bff/v2/content?lim=60&page={page}&sort=rel&store_id={store_id}"
+            "&status=active&gl=3&include=extend_with_shipping"
+        )
+        return _make_request(url=f"{url}", token=self.token).json()

{blocket_api-0.2.7 → blocket_api-0.2.8}/blocket_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.2.7
+Version: 0.2.8
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
@@ -11,7 +11,7 @@ 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: ruff>=0.12.3
+Requires-Dist: ruff>=0.12.4
 Dynamic: license-file
 
 # BlocketAPI
@@ -27,9 +27,9 @@ BlocketAPI allows users to query saved searches, known as "Bevakningar", on [blo
 - List saved searches, called "Bevakningar".
 - Get listings from all or a specific saved search.
 - Search for anything on Blocket with filters for region and category.
-- Advanced search for vehicles with multiple filters.
-- Get vehicle information and price evaluation.
+- Get vehicle information, price evaluation and search for vehicles with multiple filters.
 - Search for homes with filters for city, home type and more.
+- Search for stores and get a specific store's listings.
 
 ## 🧑‍💻️ Install
 
@@ -50,7 +50,7 @@ pip install blocket-api
 ...
 ```
 
-Some calls require a bearerToken. However, some calls are public and don't require a token.
+Some calls require a `bearerToken`. However, some calls are public and don't require a token.
 
 [Where token?](#-blocket-api-token)
 
@@ -63,6 +63,8 @@ Some calls require a bearerToken. However, some calls are public and don't requi
 | [`api.motor_search()`](#motor_searchpage-make-fuel-chassi-price-modelyear-milage-gearbox)  | 👏 No | Advanced search for car-listings. |
 | [`api.price_eval()`](#price_evalregistration_number)  | 👏 No | Vehicle purchase valuation and details. | 
 | [`api.home_search()`](#home_searchcity-type-order_by-ordering-offset)  | 👏 No | Query home listings.
+| [`api.store_search()`](#store_searchsearch_query-page)  | 👏 No | Search for a store.
+| [`api.get_store_listings()`](#get_store_listingsstore_id-page)  | 👏 No | Get listings from a specific store.
 
 ## 🤓 Detailed usage
 
@@ -221,6 +223,48 @@ Query home listings from [bostad.blocket.se](https://bostad.blocket.se/).
 ...
 ```
 
+### store_search(search_query, page)
+Search for a store in Blocket stores from [blocket.se/butiker](https://www.blocket.se/butiker).
+
+- `search_query` (`str`, required) - The name of the store. 
+- `page` (`int`, optional) - The page number to return.
+
+```py
+>>> api.store_search("Jannes Car and Kebab")
+{
+  "data": [
+    {
+      "store_id": "1234",
+      "store_name": "Jannes Car and Kebab",
+      ...
+    },
+    ...
+  ]
+}
+```
+
+### get_store_listings(store_id, page)
+Get listings from a specific store.
+
+- `store_id` (`int`, required) - The store id. Can be obtained by calling `store_search()`.
+- `page` (`int`, optional) - The page number to return.
+
+```py
+>>> api.get_store_listings(1234)
+{
+  "data": [
+    {
+      "ad_id": "1234",
+      "price": 316000,
+      "body": "A very nice car.",
+      "images": [],
+      ...
+    },
+    ...
+  ]
+}
+```
+
 ## 🔐 Blocket API token
 
 There are two ways to acquire your token:

{blocket_api-0.2.7 → blocket_api-0.2.8}/blocket_api.egg-info/requires.txt

@@ -3,4 +3,4 @@ pre-commit>=3.7.1
 pytest>=8.2.2
 respx>=0.21.1
 mypy>=1.15.0
-ruff>=0.12.3
+ruff>=0.12.4

{blocket_api-0.2.7 → blocket_api-0.2.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "blocket_api"
-version = "0.2.7"
+version = "0.2.8"
 description = "A python API wrapper for blocket.se"
 authors = [{name = "dunderrrrrr", email = "emil.bjorkroth@gmail.com"}]
 readme = "README.md"
@@ -11,7 +11,7 @@ dependencies = [
     "pytest>=8.2.2",
     "respx>=0.21.1",
     "mypy>=1.15.0",
-    "ruff>=0.12.3",
+    "ruff>=0.12.4",
 ]