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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.2.5
+Version: 0.2.7
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
@@ -8,10 +8,10 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: pre-commit>=3.7.1
-Requires-Dist: ruff>=0.5.2
 Requires-Dist: pytest>=8.2.2
 Requires-Dist: respx>=0.21.1
 Requires-Dist: mypy>=1.15.0
+Requires-Dist: ruff>=0.12.3
 Dynamic: license-file
 
 # BlocketAPI
@@ -25,9 +25,11 @@ BlocketAPI allows users to query saved searches, known as "Bevakningar", on [blo
 ## ✨ Features
 
 - List saved searches, called "Bevakningar".
-- Query all listings/ads filtered on a region.
-- Query listings related to a saved search.
-- Use motor search to query listings related to a specific car.
+- 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.
+- Search for homes with filters for city, home type and more.
 
 ## 🧑‍💻️ Install
 
@@ -60,6 +62,7 @@ Some calls require a bearerToken. However, some calls are public and don't requi
 | [`api.custom_search()`](#custom_searchsearch_query-region-limit)  | 👏 No | Search for everything on Blocket and filter by region |
 | [`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.
 
 ## 🤓 Detailed usage
 
@@ -121,7 +124,8 @@ Make a custom search through out all of blocked. A region can be passed in as pa
 
 Parameters:
 - `search_query` (`str`, required) - A string to search for.
-- `region` (`str`, optional) - Filter results on a region, default is all of Sweden.
+- `region` (`enum`, optional) - Filter results on a region, default is all of Sweden.
+- `category` (`enum`, optional) - Filter for a specific category, ex. `Category.for_hemmet`.
 - `limit` (`int`, optional) - Limit number of results returned, max is 99.
 
 ```py
@@ -183,7 +187,7 @@ Query price evaluation for a specific vehicle by using cars registration number
 
 - `registration_number` (`str`, required) - Registration number of the vehicle.
 ```py
->>> api.price_eval("ABC123)
+>>> api.price_eval("ABC123")
 {
    "registration_number": "ABC123",
    "private_valuation": 108155,
@@ -197,6 +201,26 @@ Query price evaluation for a specific vehicle by using cars registration number
 }
 ```
 
+### home_search(city, type, order_by, ordering, offset)
+Query home listings from [bostad.blocket.se](https://bostad.blocket.se/).
+
+- `city` (`str`, required) - City name, ex. Stockholm. 
+- `type` (`HomeType`, optional) - Type of home, ex. `HomeType.apartment`.
+- `order_by` (`OrderBy`, optional) - Sorting order, ex. `OrderBy.price`.
+- `ordering` (`HOME_SEARCH_ORDERING`, optional) - Sorting order, ex. `"descending"`.
+- `offset` (`int`, optional) - Offset for results, ex. `60`.
+
+```py
+>>> from blocket_api.qasa import HomeType, OrderBy
+>>> api.home_search(
+    city="Stockholm",
+    type=HomeType.apartment,
+    order_by=OrderBy.price,
+    ordering="descending",
+)
+...
+```
+
 ## 🔐 Blocket API token
 
 There are two ways to acquire your token:

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

@@ -9,9 +9,11 @@ BlocketAPI allows users to query saved searches, known as "Bevakningar", on [blo
 ## ✨ Features
 
 - List saved searches, called "Bevakningar".
-- Query all listings/ads filtered on a region.
-- Query listings related to a saved search.
-- Use motor search to query listings related to a specific car.
+- 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.
+- Search for homes with filters for city, home type and more.
 
 ## 🧑‍💻️ Install
 
@@ -44,6 +46,7 @@ Some calls require a bearerToken. However, some calls are public and don't requi
 | [`api.custom_search()`](#custom_searchsearch_query-region-limit)  | 👏 No | Search for everything on Blocket and filter by region |
 | [`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.
 
 ## 🤓 Detailed usage
 
@@ -105,7 +108,8 @@ Make a custom search through out all of blocked. A region can be passed in as pa
 
 Parameters:
 - `search_query` (`str`, required) - A string to search for.
-- `region` (`str`, optional) - Filter results on a region, default is all of Sweden.
+- `region` (`enum`, optional) - Filter results on a region, default is all of Sweden.
+- `category` (`enum`, optional) - Filter for a specific category, ex. `Category.for_hemmet`.
 - `limit` (`int`, optional) - Limit number of results returned, max is 99.
 
 ```py
@@ -167,7 +171,7 @@ Query price evaluation for a specific vehicle by using cars registration number
 
 - `registration_number` (`str`, required) - Registration number of the vehicle.
 ```py
->>> api.price_eval("ABC123)
+>>> api.price_eval("ABC123")
 {
    "registration_number": "ABC123",
    "private_valuation": 108155,
@@ -181,6 +185,26 @@ Query price evaluation for a specific vehicle by using cars registration number
 }
 ```
 
+### home_search(city, type, order_by, ordering, offset)
+Query home listings from [bostad.blocket.se](https://bostad.blocket.se/).
+
+- `city` (`str`, required) - City name, ex. Stockholm. 
+- `type` (`HomeType`, optional) - Type of home, ex. `HomeType.apartment`.
+- `order_by` (`OrderBy`, optional) - Sorting order, ex. `OrderBy.price`.
+- `ordering` (`HOME_SEARCH_ORDERING`, optional) - Sorting order, ex. `"descending"`.
+- `offset` (`int`, optional) - Offset for results, ex. `60`.
+
+```py
+>>> from blocket_api.qasa import HomeType, OrderBy
+>>> api.home_search(
+    city="Stockholm",
+    type=HomeType.apartment,
+    order_by=OrderBy.price,
+    ordering="descending",
+)
+...
+```
+
 ## 🔐 Blocket API token
 
 There are two ways to acquire your token:

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

@@ -9,6 +9,8 @@ from typing import TYPE_CHECKING, Any, List, Literal, Optional, Tuple
 
 import httpx
 
+from blocket_api.qasa import HOME_SEARCH_ORDERING, HomeType, OrderBy, Qasa
+
 if TYPE_CHECKING:
     from httpx import Response
 
@@ -44,6 +46,52 @@ class Region(Enum):
     örebro = 8
 
 
+class Category(Enum):
+    fordon = 1000
+    bilar = 1020
+    bildelar_biltillbehor = 1040
+    batar = 1060
+    batdelar_tillbehor = 1080
+    husvagnar_husbilar = 1100
+    mopeder_a_traktor = 1120
+    motorcyklar = 1140
+    mc_delar_tillbehor = 1160
+    lastbil_truck_entreprenad = 1220
+    skogs_lantbruksmaskiner = 1240
+    snoskotrar = 1180
+    snoskoterdelar_tillbehor = 1200
+    for_hemmet = 2000
+    bygg_tradgard = 2020
+    mobler_heminredning = 2040
+    husgerad_vitvaror = 2060
+    verktyg = 2026
+    bostad = 3000
+    lagenheter = 3020
+    villor = 3100
+    radhus = 3120
+    tomter = 3060
+    gardar = 3070
+    fritidsboende = 3040
+    utland = 3080
+    personligt = 4000
+    klader_skor = 4080
+    accessoarer_klockor = 4060
+    barnklader_skor = 4020
+    barnartiklar_leksaker = 4040
+    elektronik = 5000
+    datorer_tv_spel = 5020
+    ljud_bild = 5040
+    telefoner_tillbehor = 5060
+    fritid_hobby = 6000
+    biljetter_resor = 6020
+    bocker_studentlitteratur = 6040
+    cyklar = 6060
+    djur = 6080
+    hobby_samlarprylar = 6100
+    hastar_ridsport = 6120
+    jakt_fiske = 6140
+
+
 MAKE_OPTIONS = Literal[
     "Audi",
     "BMW",
@@ -186,7 +234,11 @@ class BlocketAPI:
 
     @public_token
     def custom_search(
-        self, search_query: str, region: Region = Region.hela_sverige, limit: int = 99
+        self,
+        search_query: str,
+        region: Region = Region.hela_sverige,
+        category: Category | None = None,
+        limit: int = 99,
     ) -> dict:
         """
         Do a custom search through out all of Blocket.
@@ -197,10 +249,12 @@ class BlocketAPI:
         if limit > 99:
             raise LimitError("Limit cannot be greater than 99.")
 
-        return _make_request(
-            url=f"{BASE_URL}/search_bff/v2/content?lim={limit}&q={search_query}&r={region.value}&status=active",
-            token=self.token,
-        ).json()
+        url = f"{BASE_URL}/search_bff/v2/content?lim={limit}&q={search_query}&r={region.value}&status=active"
+
+        if category:
+            url += f"&cg={category.value}"
+
+        return _make_request(url=url, token=self.token).json()
 
     @public_token
     def motor_search(
@@ -259,3 +313,24 @@ class BlocketAPI:
         """
         url = f"{BYTBIL_URL}/blocket-basedata-api/v3/vehicle-data/{registration_number}"
         return _make_request(url=f"{url}", token=None).json()
+
+    def home_search(
+        self,
+        city: str,
+        type: HomeType,
+        order_by: OrderBy = OrderBy.published_at,
+        ordering: HOME_SEARCH_ORDERING = "descending",
+        offset: int = 0,
+    ) -> dict:
+        """
+        This returns all available home listings available at
+        https://bostad.blocket.se/. Specify offset to get next page. Each page contains
+        60 items, which is max items returned per api query.
+        """
+        return Qasa(
+            city=city,
+            home_type=type,
+            order_by=order_by,
+            ordering=ordering,
+            offset=offset,
+        ).search()

blocket_api-0.2.7/blocket_api/qasa.py

@@ -0,0 +1,135 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing import Literal
+import httpx
+
+QASA_URL = "https://api.qasa.se/graphql"
+HOME_SEARCH_ORDERING = Literal["descending", "ascending"]
+
+
+class OrderBy(Enum):
+    published_at = "published_or_bumped_at"
+    price = "monthly_cost_cents"
+    size = "square_meters"
+    move_in_date = "start_date"
+    move_out_date = "end_date"
+
+
+class HomeType(Enum):
+    apartment = ["apartment", "loft"]
+    house = ["house", "terrace_house", "duplex"]
+    cottage = ["cottage"]
+    corridor = ["corridor", "room"]
+    other = ["other"]
+
+
+@dataclass
+class Qasa:
+    city: str
+    home_type: HomeType
+    order_by: OrderBy
+    ordering: HOME_SEARCH_ORDERING
+    offset: int
+
+    def _construct_payload(self) -> dict:
+        return {
+            "operationName": "HomeSearch",
+            "variables": {
+                "limit": 60,  # no more than 60 items per page is allowed
+                "offset": 0,
+                "order": {
+                    "direction": f"{self.ordering}",
+                    "orderBy": f"{self.order_by.value}",
+                },
+                "params": {
+                    "currency": "SEK",
+                    "homeType": self.home_type.value,
+                    "areaIdentifier": [f"se/{self.city}"],
+                    "rentalType": ["long_term"],
+                    "markets": ["sweden"],
+                },
+            },
+            "query": """
+                query HomeSearch(
+                    $order: HomeIndexSearchOrderInput, 
+                    $offset: Int, 
+                    $limit: Int, 
+                    $params: HomeSearchParamsInput
+                ) {
+                    homeIndexSearch(order: $order, params: $params) {
+                        documents(offset: $offset, limit: $limit) {
+                            hasNextPage
+                            hasPreviousPage
+                            nodes {
+                                bedroomCount
+                                blockListing
+                                rentalLengthSeconds
+                                householdSize
+                                corporateHome
+                                description
+                                endDate
+                                firstHand
+                                furnished
+                                homeType
+                                id
+                                instantSign
+                                market
+                                lastBumpedAt
+                                monthlyCost
+                                petsAllowed
+                                platform
+                                publishedAt
+                                publishedOrBumpedAt
+                                earlyAccessEndsAt
+                                rent
+                                currency
+                                roomCount
+                                seniorHome
+                                shared
+                                shortcutHome
+                                smokingAllowed
+                                sortingScore
+                                squareMeters
+                                startDate
+                                studentHome
+                                tenantBaseFee
+                                title
+                                wheelchairAccessible
+                                location {
+                                    id
+                                    locality
+                                    countryCode
+                                    streetNumber
+                                    point {
+                                    lat
+                                    lon
+                                    __typename
+                                    }
+                                    route
+                                    __typename
+                                }
+                                displayStreetNumber
+                                uploads {
+                                    id
+                                    order
+                                    type
+                                    url
+                                    __typename
+                                }
+                                __typename
+                            }
+                            pagesCount
+                            totalCount
+                            __typename
+                        }
+                    __typename
+                    }
+                }""",
+        }
+
+    def search(self) -> dict:
+        query = self._construct_payload()
+
+        response = httpx.post(QASA_URL, json=query)
+        response.raise_for_status()
+        return response.json()

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.2.5
+Version: 0.2.7
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
@@ -8,10 +8,10 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: pre-commit>=3.7.1
-Requires-Dist: ruff>=0.5.2
 Requires-Dist: pytest>=8.2.2
 Requires-Dist: respx>=0.21.1
 Requires-Dist: mypy>=1.15.0
+Requires-Dist: ruff>=0.12.3
 Dynamic: license-file
 
 # BlocketAPI
@@ -25,9 +25,11 @@ BlocketAPI allows users to query saved searches, known as "Bevakningar", on [blo
 ## ✨ Features
 
 - List saved searches, called "Bevakningar".
-- Query all listings/ads filtered on a region.
-- Query listings related to a saved search.
-- Use motor search to query listings related to a specific car.
+- 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.
+- Search for homes with filters for city, home type and more.
 
 ## 🧑‍💻️ Install
 
@@ -60,6 +62,7 @@ Some calls require a bearerToken. However, some calls are public and don't requi
 | [`api.custom_search()`](#custom_searchsearch_query-region-limit)  | 👏 No | Search for everything on Blocket and filter by region |
 | [`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.
 
 ## 🤓 Detailed usage
 
@@ -121,7 +124,8 @@ Make a custom search through out all of blocked. A region can be passed in as pa
 
 Parameters:
 - `search_query` (`str`, required) - A string to search for.
-- `region` (`str`, optional) - Filter results on a region, default is all of Sweden.
+- `region` (`enum`, optional) - Filter results on a region, default is all of Sweden.
+- `category` (`enum`, optional) - Filter for a specific category, ex. `Category.for_hemmet`.
 - `limit` (`int`, optional) - Limit number of results returned, max is 99.
 
 ```py
@@ -183,7 +187,7 @@ Query price evaluation for a specific vehicle by using cars registration number
 
 - `registration_number` (`str`, required) - Registration number of the vehicle.
 ```py
->>> api.price_eval("ABC123)
+>>> api.price_eval("ABC123")
 {
    "registration_number": "ABC123",
    "private_valuation": 108155,
@@ -197,6 +201,26 @@ Query price evaluation for a specific vehicle by using cars registration number
 }
 ```
 
+### home_search(city, type, order_by, ordering, offset)
+Query home listings from [bostad.blocket.se](https://bostad.blocket.se/).
+
+- `city` (`str`, required) - City name, ex. Stockholm. 
+- `type` (`HomeType`, optional) - Type of home, ex. `HomeType.apartment`.
+- `order_by` (`OrderBy`, optional) - Sorting order, ex. `OrderBy.price`.
+- `ordering` (`HOME_SEARCH_ORDERING`, optional) - Sorting order, ex. `"descending"`.
+- `offset` (`int`, optional) - Offset for results, ex. `60`.
+
+```py
+>>> from blocket_api.qasa import HomeType, OrderBy
+>>> api.home_search(
+    city="Stockholm",
+    type=HomeType.apartment,
+    order_by=OrderBy.price,
+    ordering="descending",
+)
+...
+```
+
 ## 🔐 Blocket API token
 
 There are two ways to acquire your token:

{blocket_api-0.2.5 → blocket_api-0.2.7}/blocket_api.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 blocket_api/__init__.py
 blocket_api/blocket.py
+blocket_api/qasa.py
 blocket_api.egg-info/PKG-INFO
 blocket_api.egg-info/SOURCES.txt
 blocket_api.egg-info/dependency_links.txt

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

@@ -1,6 +1,6 @@
 httpx>=0.27.0
 pre-commit>=3.7.1
-ruff>=0.5.2
 pytest>=8.2.2
 respx>=0.21.1
 mypy>=1.15.0
+ruff>=0.12.3

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

@@ -1,6 +1,6 @@
 [project]
 name = "blocket_api"
-version = "0.2.5"
+version = "0.2.7"
 description = "A python API wrapper for blocket.se"
 authors = [{name = "dunderrrrrr", email = "emil.bjorkroth@gmail.com"}]
 readme = "README.md"
@@ -8,10 +8,10 @@ requires-python = ">=3.10"
 dependencies = [
     "httpx>=0.27.0",
     "pre-commit>=3.7.1",
-    "ruff>=0.5.2",
     "pytest>=8.2.2",
     "respx>=0.21.1",
     "mypy>=1.15.0",
+    "ruff>=0.12.3",
 ]