Bostad.io

Use this when you need the valid preference field codes for search_listings and what 'lowest' and 'highest' mean for each (for example water_distance lowest = closest to water, asking_price lowest = cheapest), optionally for one tenure. Returns field codes with Swedish labels and applicable tenures. Returns no listing data.

list_search_fields

Use this when you need to know which Swedish municipalities and tenure types (for example bostadsrätt or äganderätt) Bostad.io can currently search, before calling search_listings, or when the user asks where Bostad.io has homes for sale. Returns the municipality (m) and tenure (t) pairs that currently have listings from participating brokers, each with the slug to pass to search_listings. Coverage changes as brokers join or leave; it is not all of Sweden.

list_coverage

Use this when the user wants homes for sale in a Swedish municipality covered by Bostad.io, ranked by stated preferences (for example close to water, largest living area, lowest monthly fee, newest on the market) and/or short free-text wishes (for example 'bastu', 'sjöutsikt'). Returns up to 5 listings per tenure. Each listing is a link to the broker's own listing page with a relevance score and evidence: for each requested field, the listing's decile among homes currently for sale from participating brokers in that municipality and tenure; for each like/dislike item, a strong/weak/none match. Rankings are relative to that supply, not absolute. Does not return prices, sizes, addresses, distances or listing text; those are on the broker's page. Present each listing_url as returned. If unsure whether a municipality is covered, call list_coverage; for what each field's lowest and highest mean, call list_search_fields.

search_listings