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

{blocket_api-0.3.9 → blocket_api-0.3.92}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.3.9
+Version: 0.3.92
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
@@ -16,6 +16,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: beautifulsoup4>=4.14.2
 Requires-Dist: ruff>=0.14.5
 Dynamic: license-file
 
@@ -47,16 +48,43 @@ or use [blocket-api.se](https://blocket-api.se) without installing anything!
 ## 💁‍♀️ Usage
 
 ```py
-from blocket_api import BlocketAPI, Category, Location, SortOrder
+from blocket_api import (
+    BlocketAPI,
+    Category,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    Location,
+)
 
 api = BlocketAPI()
 
-result = api.search(
+# search all of blocket
+api.search(
     "Vinterdäck Audi",
     sort_order=SortOrder.PRICE_ASC,
     locations=[Location.STOCKHOLM, Location.UPPSALA],
     category=Category.FORDONSTILLBEHOR,
 )
+
+# search for cars only
+api.search_car(
+    "Audi", # query is optional
+    sort_order=CarSortOrder.MILEAGE_ASC,
+    models=[CarModel.AUDI],
+    colors=[CarColor.GULD],
+    price_from=10000,
+    price_to=50000,
+    transmissions=[CarTransmission.MANUAL],
+    locations=[Location.STOCKHOLM],
+)
+
+# Get a recommerce or car ad
+from blocket_api import CarAd, RecommerceAd
+
+api.get_ad(RecommerceAd(12345678))
+api.get_ad(CarAd(12345678))
 ```
 
 ## 📝 Notes

{blocket_api-0.3.9 → blocket_api-0.3.92}/README.md

@@ -26,16 +26,43 @@ or use [blocket-api.se](https://blocket-api.se) without installing anything!
 ## 💁‍♀️ Usage
 
 ```py
-from blocket_api import BlocketAPI, Category, Location, SortOrder
+from blocket_api import (
+    BlocketAPI,
+    Category,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    Location,
+)
 
 api = BlocketAPI()
 
-result = api.search(
+# search all of blocket
+api.search(
     "Vinterdäck Audi",
     sort_order=SortOrder.PRICE_ASC,
     locations=[Location.STOCKHOLM, Location.UPPSALA],
     category=Category.FORDONSTILLBEHOR,
 )
+
+# search for cars only
+api.search_car(
+    "Audi", # query is optional
+    sort_order=CarSortOrder.MILEAGE_ASC,
+    models=[CarModel.AUDI],
+    colors=[CarColor.GULD],
+    price_from=10000,
+    price_to=50000,
+    transmissions=[CarTransmission.MANUAL],
+    locations=[Location.STOCKHOLM],
+)
+
+# Get a recommerce or car ad
+from blocket_api import CarAd, RecommerceAd
+
+api.get_ad(RecommerceAd(12345678))
+api.get_ad(CarAd(12345678))
 ```
 
 ## 📝 Notes

blocket_api-0.3.92/blocket_api/__init__.py

@@ -0,0 +1,11 @@
+from .ad_parser import CarAd as CarAd
+from .ad_parser import RecommerceAd as RecommerceAd
+from .blocket import BlocketAPI as BlocketAPI
+from .blocket import Location as Location
+from .constants import CarColor as CarColor
+from .constants import CarModel as CarModel
+from .constants import CarSortOrder as CarSortOrder
+from .constants import CarTransmission as CarTransmission
+from .constants import Category as Category
+from .constants import SortOrder as SortOrder
+from .constants import SubCategory as SubCategory

blocket_api-0.3.92/blocket_api/ad_parser.py

@@ -0,0 +1,182 @@
+import json
+import re
+from dataclasses import dataclass
+from typing import Any
+
+from bs4 import BeautifulSoup, Tag
+from httpx import Response
+
+from .constants import SITE_URL
+
+
+@dataclass(frozen=True)
+class RecommerceAd:
+    id: int
+
+    @property
+    def url(self) -> str:
+        return f"{SITE_URL}/recommerce/forsale/item/{self.id}"
+
+    def parse(self, response: Response) -> Any:
+        soup = BeautifulSoup(response.content, "html.parser")
+        json_script_tag = soup.select_one(
+            'script:-soup-contains("window.__staticRouterHydrationData")'
+        )
+        if not json_script_tag:
+            return {}
+
+        if match := re.search(r'JSON\.parse\("(.+)"\)', json_script_tag.text):
+            raw_json = match.group(1)
+            escaped = raw_json.encode("utf-8").decode("unicode_escape")
+            return json.loads(escaped.encode("latin1").decode("utf-8"))
+        else:
+            return {}
+
+
+@dataclass(frozen=True)
+class CarAd:
+    id: int
+
+    @property
+    def url(self) -> str:
+        return f"{SITE_URL}/mobility/item/{self.id}"
+
+    def parse(self, response: Response) -> dict:
+        soup = BeautifulSoup(response.content, "html.parser")
+        grid = soup.find("div", class_="grid grid-cols-1 md:grid-cols-3 md:gap-x-32")
+
+        if not grid:
+            return {}
+
+        data: dict[str, Any] = {"url": self.url}
+
+        self._extract_title_and_subtitle(grid, data)
+        self._extract_quick_specs(grid, data)
+        self._extract_price(grid, data)
+        self._extract_description(grid, data)
+        self._extract_specifications(grid, data)
+        self._extract_equipment(grid, data)
+        self._extract_seller_type(soup, data)
+        self._extract_ad_id(soup, data)
+
+        return data
+
+    def _extract_title_and_subtitle(self, grid: Tag, data: dict[str, Any]) -> None:
+        if title := grid.find("h1", class_=lambda x: x and "t1" in x):
+            data["title"] = title.get_text(strip=True)
+
+        if subtitle := grid.find(
+            "p", class_=lambda x: x and "s-text-subtle" in x and "mt-8" in x
+        ):
+            data["subtitle"] = subtitle.get_text(strip=True)
+
+    def _extract_quick_specs(self, grid: Tag, data: dict[str, Any]) -> None:
+        if specs_grid := grid.find(
+            "div", class_=lambda x: x and "grid" in x and "gap-24" in x
+        ):
+            spec_items = specs_grid.find_all("div", class_="flex gap-16 hyphens-auto")
+            for item in spec_items:
+                label = item.find("span", class_="s-text-subtle")
+                value = item.find("p", class_="m-0 font-bold")
+                if label and value:
+                    label_text = label.get_text(strip=True)
+                    value_text = value.get_text(strip=True)
+
+                    key_mapping = {
+                        "Modellår": "model_year",
+                        "Miltal": "mileage",
+                        "Växellåda": "transmission",
+                        "Drivmedel": "fuel",
+                    }
+                    key = key_mapping.get(
+                        label_text, label_text.lower().replace(" ", "_")
+                    )
+                    data[key] = value_text
+
+    def _extract_price(self, grid: Tag, data: dict[str, Any]) -> None:
+        if price_section := grid.find("div", class_="border-t pt-40 mt-40"):
+            price_labels = price_section.find_all("p", class_="s-text-subtle mb-0")
+            for price_label in price_labels:
+                label_text = price_label.get_text(strip=True).lower()
+                if "pris" in label_text:
+                    price_elem = price_section.find("span", class_="t2")
+                    if price_elem:
+                        data["price"] = price_elem.get_text(strip=True)
+                    break
+                elif "månadskostnad" in label_text:
+                    monthly_elem = price_section.find("h2", class_="t2")
+                    if monthly_elem:
+                        data["monthly_cost"] = monthly_elem.get_text(strip=True)
+                    break
+
+    def _extract_description(self, grid: Tag, data: dict[str, Any]) -> None:
+        desc_sections = grid.find_all("section", class_="border-t mt-40 pt-40")
+        for section in desc_sections:
+            h2 = section.find("h2", class_="t3 mb-0")
+            if h2 and "beskrivning" in h2.get_text(strip=True).lower():
+                desc_div = section.find("div", class_="whitespace-pre-wrap")
+                if desc_div:
+                    data["description"] = desc_div.get_text(strip=True)
+                break
+
+    def _extract_specifications(self, grid: Tag, data: dict[str, Any]) -> None:
+        specs_section = grid.find("section", class_="key-info-section")
+        if not specs_section:
+            return
+
+        dl = specs_section.find("dl")
+        if not dl:
+            return
+
+        specifications: dict[str, str] = {}
+        divs = dl.find_all("div", style="break-inside:avoid-column")
+        for div in divs:
+            dt = div.find("dt")
+            dd = div.find("dd")
+            if dt and dd:
+                key_text = dt.get_text(strip=True)
+                value_text = dd.get_text(strip=True)
+                specifications[key_text] = value_text
+
+        if specifications:
+            data["specifications"] = specifications
+
+    def _extract_equipment(self, grid: Tag, data: dict[str, Any]) -> None:
+        equipment_section: Tag | None = None
+        for section in grid.find_all("section", class_="border-t pt-40 mt-40"):
+            h2 = section.find("h2", class_="t3 mb-0")
+            if h2 and "utrustning" in h2.get_text(strip=True).lower():
+                equipment_section = section
+                break
+
+        if not equipment_section:
+            return
+
+        equipment_list = equipment_section.find("ul")
+        if equipment_list:
+            equipment_items: list[str] = [
+                li.get_text(strip=True) for li in equipment_list.find_all("li")
+            ]
+            if equipment_items:
+                data["equipment"] = equipment_items
+
+    def _extract_seller_type(self, soup: BeautifulSoup, data: dict[str, Any]) -> None:
+        seller_type = (
+            "dealer"
+            if soup.find("div", class_=lambda x: x and "dealer" in str(x).lower())
+            else "private"
+        )
+        data["seller_type"] = seller_type
+
+    def _extract_ad_id(self, soup: BeautifulSoup, data: dict[str, Any]) -> None:
+        ad_info_divs = soup.find_all(
+            "div", class_="text-m flex md:flex-row flex-col md:gap-x-56 gap-y-16"
+        )
+        for div in ad_info_divs:
+            ad_id_labels = div.find_all("p", class_="s-text-subtle mb-0")
+            for ad_id_label in ad_id_labels:
+                if "Annons-ID" in ad_id_label.get_text(strip=True):
+                    ad_id_elem = ad_id_label.find_next_sibling("p")
+                    if ad_id_elem:
+                        data["ad_id"] = ad_id_elem.get_text(strip=True)
+                        break

blocket_api-0.3.92/blocket_api/blocket.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+import httpx
+from httpx import Response
+
+from .ad_parser import CarAd, RecommerceAd
+from .constants import (
+    HEADERS,
+    SITE_URL,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    Category,
+    Location,
+    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,
+        *,
+        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).json()
+
+    def search_car(
+        self,
+        query: str | None = None,
+        *,
+        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] = [],
+    ) -> Any:
+        url = f"{SITE_URL}/mobility/search/api/search/SEARCH_ID_CAR_USED"
+        params = [
+            *([QueryParam("q", query)] if query else []),
+            QueryParam("sort", sort_order.value),
+            *[QueryParam("location", location.value) for location in locations],
+            *[QueryParam("make", model.value) for model in models],
+            *([QueryParam("price_from", price_from)] if price_from else []),
+            *([QueryParam("price_to", price_to)] if price_to else []),
+            *([QueryParam("year_from", year_from)] if year_from else []),
+            *([QueryParam("year_to", year_to)] if year_to else []),
+            *([QueryParam("milage_from", milage_from)] if milage_from else []),
+            *([QueryParam("milage_to", milage_to)] if milage_to else []),
+            *[QueryParam("exterior_colour", color.value) for color in colors],
+            *[QueryParam("transmission", t.value) for t in transmissions],
+        ]
+
+        return _request(url=url, params=params).json()
+
+    def get_ad(self, ad: RecommerceAd | CarAd) -> dict:
+        response = _request(url=ad.url, params=[])
+        return ad.parse(response)

blocket_api-0.3.92/blocket_api/constants.py

@@ -0,0 +1,350 @@
+from enum import IntEnum, 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 CarSortOrder(StrEnum):
+    RELEVANCE = "RELEVANCE"
+    PRICE_DESC = "PRICE_DESC"
+    PRICE_ASC = "PRICE_ASC"
+    PUBLISHED_DESC = "PUBLISHED_DESC"
+    PUBLISHED_ASC = "PUBLISHED_ASC"
+
+    # Car specific
+    MILEAGE_DESC = "MILEAGE_DESC"
+    MILEAGE_ASC = "MILEAGE_ASC"
+    MODEL = "MODEL"
+    YEAR_DESC = "YEAR_DESC"
+    YEAR_ASC = "YEAR_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_GOTALAND = "0.300014"
+    OREBRO = "0.300018"
+    OSTERGOTLAND = "0.300005"
+
+
+class Category(StrEnum):
+    AFFARSVERKSAMHET = "0.91"
+    DJUR_OCH_TILLBEHOR = "0.77"
+    ELEKTRONIK_OCH_VITVAROR = "0.93"
+    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"
+    MOBLER_OCH_INREDNING = "0.78"
+    SPORT_OCH_FRITID = "0.69"
+    TRADGARD_OCH_RENOVERING = "0.67"
+
+
+class SubCategory(StrEnum):
+    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"
+    BILDELAR_OCH_TILLBEHOR = "1.90.82"
+    HUSVAGNS_OCH_HUSBILSDELAR = "1.90.70"
+    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"
+    MC_UTRUSTNING_OCH_RESERVDELAR = "1.90.20"
+    BILJETTER_OCH_RESOR = "1.86.7735"
+    BOCKER_OCH_TIDNINGAR = "1.86.5209"
+    HANTVERK = "1.86.7734"
+    MAT_OCH_DRYCK = "1.86.3972"
+    MODELLER_OCH_BYGGSATSER = "1.86.7732"
+    MUSIK_OCH_FILM = "1.86.3922"
+    MUSIKINSTRUMENT = "1.86.92"
+    RADIOSTYRDA_ENHETER = "1.86.7733"
+    SAMLAROBJEKT = "1.86.285"
+    SALLSKAPS_OCH_BRADSPEL = "1.86.5203"
+    BARNBOCKER = "1.68.8369"
+    BARNKLADER = "1.68.3913"
+    BARNMOBLER = "1.68.3916"
+    BARNSKOR = "1.68.3915"
+    BARNTILLBEHOR_OCH_SAKERHET = "1.68.3918"
+    BARNVAGNAR = "1.68.3914"
+    BILBARNSTOLAR_OCH_BABYSKYDD = "1.68.3911"
+    GRAVIDKLADER = "1.68.3948"
+    INREDNING_TILL_BARNRUM = "1.68.9445"
+    LEKSAKER = "1.68.3912"
+    ACCESSOARER = "1.71.9481"
+    DAMKLADER = "1.71.3941"
+    GLASOGON_OCH_SOLGLASOGON = "1.71.8344"
+    HERRKLADER = "1.71.3950"
+    HUD_HAR_OCH_KROPPSVARD = "1.71.8280"
+    KLOCKOR_OCH_ARMBANDSUR = "1.71.3945"
+    KOSMETIK = "1.71.8282"
+    MASKERADKLADER = "1.71.8349"
+    SKOR = "1.71.3949"
+    SMYCKEN_OCH_SMYCKESFORVARING = "1.71.7748"
+    VASKOR_OCH_PLANBOCKER = "1.71.3946"
+    ANTIKA_MOBLER = "1.76.5178"
+    KERAMIK_PORSLIN_OCH_GLAS = "1.76.5176"
+    KONST = "1.76.5177"
+    SILVERFOREMAL_OCH_SILVERBESTICK = "1.76.5179"
+    OVRIGA_ANTIKVITETER = "1.76.5175"
+    BORD_OCH_STOLAR = "1.78.5196"
+    DEKORATION_OCH_PRYDNADER = "1.78.5222"
+    GARDEROBER_OCH_FORVARING = "1.78.5198"
+    HYLLOR_OCH_BYRAER = "1.78.8345"
+    KOKSUTRUSTNING_OCH_PORSLIN = "1.78.5223"
+    LAMPOR = "1.78.5181"
+    MATTOR_OCH_TEXTILIER = "1.78.5180"
+    PYNT_TILL_HOGTIDER_OCH_FEST = "1.78.9760"
+    SOFFOR_OCH_FATOLJER = "1.78.7756"
+    SANGAR_OCH_MADRASSER = "1.78.5197"
+    OVRIGA_MOBLER_OCH_INREDNING = "1.78.3971"
+    BOLLSPORTER = "1.69.3961"
+    CYKEL = "1.69.3963"
+    EXTREMSPORT = "1.69.3938"
+    GOLF = "1.69.5164"
+    JAKT_FISKE_OCH_CAMPING = "1.69.3964"
+    KOSTTILLSKOTT = "1.69.8281"
+    RULLSKRIDSKOR_ISHOCKEY_OCH_KONSTAKNING = "1.69.8346"
+    SKYTTE = "1.69.3965"
+    SUPPORTERPRODUKTER = "1.69.3937"
+    TRANINGSKLOCKOR_OCH_AKTIVITETSARMBAND = "1.69.3967"
+    TRANINGSKLADER_OCH_SKOR = "1.69.3940"
+    TRANINGSUTRUSTNING = "1.69.5166"
+    VATTENSPORT = "1.69.7738"
+    VINTERSPORT = "1.69.3962"
+    OVRIGA_SPORTER = "1.69.3966"
+    BADRUM_OCH_BASTU = "1.67.7749"
+    BYGGMATERIAL_OCH_RENOVERING = "1.67.3899"
+    GARAGEDELAR_OCH_TILLBEHOR = "1.67.8348"
+    KOKSINREDNING_OCH_KOKSSTOMMAR = "1.67.3900"
+    LARM_OCH_SAKERHET = "1.67.8347"
+    TRADGARD_OCH_UTEMILJO = "1.67.3901"
+    UTRUSTNING_FOR_FRITIDSHUS = "1.67.3968"
+    VERKTYG = "1.67.5219"
+    VARME_OCH_VENTILATION = "1.67.5218"
+    OVRIGT = "1.67.3969"
+
+
+class CarModel(StrEnum):
+    ABARTH = "0.8093"
+    AC = "0.200673"
+    ACURA = "0.200674"
+    AIWAYS = "0.200681"
+    ALFA_ROMEO = "0.3233"
+    ALPINA = "0.8092"
+    AMC = "0.8103"
+    ARIEL = "0.8110"
+    ARMSTRONG_SIDDELEY = "0.1156"
+    ASTON_MARTIN = "0.6733"
+    AUDI = "0.744"
+    AUSTIN = "0.8076"
+    AUSTIN_HEALEY = "0.200688"
+    AUTO_UNION = "0.200689"
+    AUTOBIANCHI = "0.200690"
+    BEDFORD = "0.200693"
+    BENTLEY = "0.7166"
+    BMW = "0.749"
+    BUGATTI = "0.8111"
+    BUICK = "0.750"
+    BYD = "0.8101"
+    CADILLAC = "0.752"
+    CATERHAM = "0.200704"
+    CHEVROLET = "0.753"
+    CHRYSLER = "0.754"
+    CITROEN = "0.757"
+    CUPRA = "0.8106"
+    DACIA = "0.8079"
+    DAEWOO = "0.760"
+    DAF = "0.8090"
+    DAIHATSU = "0.762"
+    DAIMLER = "0.200711"
+    DATSUN = "0.8089"
+    DE_TOMASO = "0.8069"
+    DELOREAN = "0.8085"
+    DESOTO = "0.200715"
+    DFSK = "0.2174"
+    DKW = "0.200718"
+    DODGE = "0.764"
+    DS = "0.8091"
+    EDSEL = "0.200723"
+    ERSKINE = "0.200726"
+    EXCALIBUR = "0.200727"
+    FERRARI = "0.2999"
+    FIAT = "0.766"
+    FISKER = "0.8073"
+    FORD = "0.767"
+    FORDSON = "0.200730"
+    GAZ = "0.200734"
+    GINETTA = "0.200738"
+    GMC = "0.7547"
+    HEINKEL = "0.200745"
+    HILLMAN = "0.200746"
+    HOLDEN = "0.200747"
+    HONDA = "0.771"
+    HONGQI = "0.8107"
+    HUDSON = "0.200748"
+    HUMBER = "0.200749"
+    HUMMER = "0.7672"
+    HYUNDAI = "0.772"
+    INEOS = "0.2000665"
+    INFINITI = "0.8065"
+    INTERNATIONAL = "0.1160"
+    ISUZU = "0.7179"
+    IVECO = "0.7280"
+    JAC = "0.8114"
+    JAGUAR = "0.775"
+    JEEP = "0.776"
+    JENSEN = "0.774"
+    KAISER_JEEP = "0.1162"
+    KGM = "0.2000649"
+    KIA = "0.777"
+    KTM = "0.200761"
+    LADA = "0.779"
+    LAMBORGHINI = "0.6731"
+    LANCIA = "0.780"
+    LAND_ROVER = "0.781"
+    LEVC = "0.200764"
+    LEXUS = "0.782"
+    LEYLAND = "0.200765"
+    LINCOLN = "0.7153"
+    LOTUS = "0.7191"
+    LYNK_CO = "0.200769"
+    MAN = "0.8097"
+    MASERATI = "0.3001"
+    MAXUS = "0.8096"
+    MAZDA = "0.784"
+    MCLAREN = "0.8087"
+    MERCEDES_BENZ = "0.785"
+    MERCURY = "0.7554"
+    MESSERSCHMITT = "0.200774"
+    MG = "0.786"
+    MINI = "0.7147"
+    MINI_MARCOS = "0.200775"
+    MITSUBISHI = "0.787"
+    MORGAN = "0.788"
+    MORRIS = "0.789"
+    NIO = "0.8109"
+    NISSAN = "0.792"
+    OLDSMOBILE = "0.794"
+    OPEL = "0.795"
+    PACKARD = "0.8077"
+    PEUGEOT = "0.796"
+    PLYMOUTH = "0.797"
+    POLESTAR = "0.8102"
+    PONTIAC = "0.800"
+    PORSCHE = "0.801"
+    PRO_SPORT = "0.200792"
+    RADICAL = "0.8088"
+    RAM = "0.8100"
+    RENAULT = "0.804"
+    ROLLS_ROYCE = "0.7170"
+    ROVER = "0.805"
+    SAAB = "0.806"
+    SCION = "0.822"
+    SEAT = "0.807"
+    SERES = "0.8108"
+    SHELBY = "0.1142"
+    SIMCA = "0.200807"
+    SKODA = "0.808"
+    SMART = "0.7137"
+    SSANGYONG = "0.7190"
+    STANDARD = "0.200812"
+    STUDEBAKER = "0.200815"
+    SUBARU = "0.810"
+    SUZUKI = "0.811"
+    TESLA = "0.8078"
+    TOYOTA = "0.813"
+    TRABANT = "0.200824"
+    TRIUMPH = "0.814"
+    TVR = "0.820"
+    VAUXHALL = "0.200827"
+    VOLKSWAGEN = "0.817"
+    VOLVO = "0.818"
+    WILLYS = "0.200834"
+    XPENG = "0.8104"
+    ZEEKR = "0.200841"
+    ZIMMER = "0.200844"
+    OVRIGA = "0.2252"
+
+
+class CarColor(IntEnum):
+    BEIGE = 1
+    BLA = 2
+    BRONS = 3
+    BRUN = 4
+    GRA = 6
+    GRON = 5
+    GUL = 7
+    GULD = 8
+    VIT = 9
+    LILA = 10
+    ORANGE = 11
+    ROSA = 12
+    ROD = 13
+    SILVER = 15
+    SVART = 14
+    TURKOS = 16
+
+
+class CarTransmission(IntEnum):
+    AUTOMATIC = 2
+    MANUAL = 1

{blocket_api-0.3.9 → blocket_api-0.3.92}/blocket_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blocket_api
-Version: 0.3.9
+Version: 0.3.92
 Summary: A python API wrapper for blocket.se
 Author-email: dunderrrrrr <emil.bjorkroth@gmail.com>
 Requires-Python: >=3.10
@@ -16,6 +16,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: beautifulsoup4>=4.14.2
 Requires-Dist: ruff>=0.14.5
 Dynamic: license-file
 
@@ -47,16 +48,43 @@ or use [blocket-api.se](https://blocket-api.se) without installing anything!
 ## 💁‍♀️ Usage
 
 ```py
-from blocket_api import BlocketAPI, Category, Location, SortOrder
+from blocket_api import (
+    BlocketAPI,
+    Category,
+    CarColor,
+    CarModel,
+    CarSortOrder,
+    CarTransmission,
+    Location,
+)
 
 api = BlocketAPI()
 
-result = api.search(
+# search all of blocket
+api.search(
     "Vinterdäck Audi",
     sort_order=SortOrder.PRICE_ASC,
     locations=[Location.STOCKHOLM, Location.UPPSALA],
     category=Category.FORDONSTILLBEHOR,
 )
+
+# search for cars only
+api.search_car(
+    "Audi", # query is optional
+    sort_order=CarSortOrder.MILEAGE_ASC,
+    models=[CarModel.AUDI],
+    colors=[CarColor.GULD],
+    price_from=10000,
+    price_to=50000,
+    transmissions=[CarTransmission.MANUAL],
+    locations=[Location.STOCKHOLM],
+)
+
+# Get a recommerce or car ad
+from blocket_api import CarAd, RecommerceAd
+
+api.get_ad(RecommerceAd(12345678))
+api.get_ad(CarAd(12345678))
 ```
 
 ## 📝 Notes

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

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

{blocket_api-0.3.9 → blocket_api-0.3.92}/blocket_api.egg-info/requires.txt

@@ -8,4 +8,5 @@ mkdocs>=1.6.1
 mkdocs-material>=9.6.21
 mkdocs-swagger-ui-tag>=0.7.2
 websockets>=15.0.1
+beautifulsoup4>=4.14.2
 ruff>=0.14.5

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

@@ -1,6 +1,6 @@
 [project]
 name = "blocket_api"
-version = "0.3.9"
+version = "0.3.92"
 description = "A python API wrapper for blocket.se"
 authors = [{name = "dunderrrrrr", email = "emil.bjorkroth@gmail.com"}]
 readme = "README.md"
@@ -16,6 +16,7 @@ dependencies = [
     "mkdocs-material>=9.6.21",
     "mkdocs-swagger-ui-tag>=0.7.2",
     "websockets>=15.0.1",
+    "beautifulsoup4>=4.14.2",
     "ruff>=0.14.5",
 ]
 

blocket_api-0.3.9/blocket_api/__init__.py

@@ -1,5 +0,0 @@
-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

@@ -1,54 +0,0 @@
-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

@@ -1,107 +0,0 @@
-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"