Skip to main content
POST
/
api
/
hemnet
/
brokers
/
search
/hemnet/brokers/search
curl --request POST \
  --url https://api.anysite.io/api/hemnet/brokers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "location_ids": [
    "17744"
  ],
  "name": "<string>",
  "type": "broker",
  "sort": "last_sale"
}
'
[
  {
    "id": "<string>",
    "type": "<string>",
    "@type": "@hemnet_broker_result",
    "name": "<string>",
    "alias": "<string>",
    "sale_count": 123,
    "sale_count_in_area": 123,
    "profile_url": "<string>",
    "image": "<string>",
    "agency": {
      "@type": "@hemnet_broker_agency_ref",
      "id": "<string>",
      "name": "<string>",
      "alias": "<string>",
      "sale_count": 123
    }
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max number of results to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
location_ids
string[] | null

Hemnet numeric location ids for area search (resolve free text via hemnet/locations/search)

Example:
["17744"]
​
name
string | null

Search brokers by name instead of by area

Minimum string length: 1
​
type
enum<string>
default:broker

Search individual brokers or broker agencies (area search only)

Available options:
broker,
agency
​
radius
enum<string> | null

Expand the area search by this radius

Available options:
1,
2,
5,
10,
15,
30,
50,
100
​
sort
enum<string>
default:last_sale

Result ordering (area search only)

Available options:
last_sale,
sales_in_area,
total_sales,
name_asc,
name_desc

Response

Successful Response

​
id
string
required
​
type
string
required
​
@type
string
default:@hemnet_broker_result
​
name
string | null
​
alias
string | null
​
sale_count
integer | null
​
sale_count_in_area
integer | null
​
profile_url
string | null
​
image
string | null
​
agency
HemnetBrokerAgencyRef · object