Category methods

trojmiastopl.category.get_category(category, region=None, **filters)[source]

Parses available offer urls from given category from every page

Parameters:
  • category – Search category
  • region – Search region
  • filters – Dictionary with additional filters. Following example dictionary contains every possible filter

with examples of it’s values.

Example:
input_dict = {

“offer_type”: “Mieszkanie”, # offer type. See :meth:`utils.decode_type’ for reference “cena[]”: (300, None), # price (from, to). None if you don’t want to pass one of arguments “kaucja[]: (100,1000), # deposit “cena_za_m2[]”: (5, 100), # price/surface “powierzchnia[]”: (23, 300), # surface “l_pokoi[]”: (2, 5), # desired number of rooms “pietro[]”: (-1, 6), # desired floor, enum: from 1 to 49 and -1 (ground floor) “l_pieter[]”: (1, 10), # desired total number of floors in building “rok_budowy[]”: (2003, 2017), # date of built “data_wprow”: “1d” # date of adding offer. Available: 1d - today, 3d - 3 days ago, 1w - one week ago,

# 3w - 3 weeks ago

}

Returns:List of all offers for given parameters
Return type:list
trojmiastopl.category.get_offers_for_page(category, region, page, **filters)[source]

Parses offers for one specific page of given category with filters.

Parameters:
  • category (str) – Search category
  • region (str) – Search region
  • page (int) – Page number
  • filters (dict) – See :meth category.get_category for reference
Returns:

List of all offers for given page and parameters

Return type:

list

trojmiastopl.category.get_page_count(markup)[source]

Reads total page number from trojmiasto.pl search page

Parameters:markup (str) – trojmiasto.pl search page markup
Returns:Total page number
Return type:int
Except:If no page number was found - there is just one page.
trojmiastopl.category.get_page_count_for_filters(category, region=None, **filters)[source]

Reads total page number for given search filters

Parameters:
  • category (str) – Search category
  • region (str) – Search region
  • filters (dict) – See :meth category.get_category for reference
Returns:

Total page number

Return type:

int

Except:

If no page number was found - there is just one page.

trojmiastopl.category.parse_available_offers(markup)[source]

Collects all offer links on search page markup

Parameters:markup (str) – Search page markup
Returns:Links to offer on given search page
Return type:list
trojmiastopl.category.parse_offer_url(markup)[source]

Searches for offer links in markup

Parameters:markup (str) – Search page markup
Returns:Url with offer
Return type:str