ads market share

Get market share of brokers in percentage

The code below gives an example of how to use the client to get the market percentage of brokers involved in active sales for the area.

import valueguard

vgClient = valueguard.Client()
vgClient.authenticate("<username>", "<password>")

print(vgClient.ads_market_share(search_criteria={
    "category":"apartment",
    "rt90x_min":"6586700",
    "rt90x_max":"6596700",
    "rt90y_min":"1367905",
    "rt90y_max":"1377905"
}))

Response

Field list

Field name	Description	Example
firm	Firm	notar
market_share	Percentage of total ads in the area	30
number_of_ads	Number of ads for this firm	50

Summary

Field name	Description	Example
total_ads	Total number of ads combined for all firms	200

Search criteria fields

Field name	Description	Example
category	Category of residence	apartment
rooms_min	Minimum number of rooms	3
rooms_max	Maximum number of rooms	5
living_area_min	Minimum area of residence in sqm	117
living_area_max	Maximum area of residence in sqm	137
construction_year_min	Earliest allowed construction year of the property	1920
construction_year_max	Latest allowed construction year of the property	1950
ancillary_area_min	Minimum ancillary area in sqm, not part of the primary building area	21
ancillary_area_max	Maximum ancillary area in sqm, not part of the primary building area	25
price_min	Minimum last price on the ad	1700000
price_max	Maximum last price on the ad	2100000
monthly_fee_min	Minimum monthly fee	3554
monthly_fee_max	Maximum monthly fee	3954
registered_date_min	Earliest allowed date the advertisement was registered	2012-03-23
registered_date_max	Latest allowed date the advertisement was registered	2012-04-23
rt90x_min	X-coordinate (longitude) from RT90. a Swedish positioning system by LMV used before 2007	6586700
rt90y_min	Y-coordinate (latitude) from RT90. a Swedish positioning system by LMV used before 2007	1367905
rt90x_max	X-coordinate (longitude) from RT90. a Swedish positioning system by LMV used before 2007	6596700
rt90y_max	Y-coordinate (latitude) from RT90. a Swedish positioning system by LMV used before 2007	1377905

Raw request

Get

curl https://api.valueguard.se/v1/ads/market_share?access_token={access_token}&rt90x_min={6586700}&rt90y_min={1367905}&rt90x_max={6596700}&rt90y_max={1377905}