Skip to main content
POST
/
api
/
immobiliare
/
agencies
/
search
/immobiliare/agencies/search
curl --request POST \
  --url https://api.anysite.io/api/immobiliare/agencies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "location": "<string>",
  "count": 2,
  "timeout": 300,
  "contract": "all",
  "franchising": "<string>"
}
'
[
  {
    "id": 123,
    "@type": "@immobiliare_agency_list_item",
    "name": "<string>",
    "url": "<string>",
    "type": "<string>",
    "description": "<string>",
    "address": "<string>",
    "phone": "<string>",
    "image": "<string>",
    "association": "<string>",
    "listing_count": 123,
    "sale_listing_count": 123,
    "years_on_site": 123,
    "quality_index": 123,
    "badge": "<string>",
    "is_guaranteed": true,
    "location": {
      "@type": "@immobiliare_agency_location",
      "address": "<string>",
      "city": "<string>",
      "province": "<string>",
      "region": "<string>",
      "zone": "<string>",
      "latitude": 123,
      "longitude": 123
    }
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
location
string
required

City or province to search agencies in

Minimum string length: 1
Examples:

"Roma"

"Milano"

​
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
​
contract
enum<string>
default:all

Agency listing contract

Available options:
all,
sale,
rent
​
association
enum<string> | null

Filter by real estate association membership

Available options:
anama,
fiaip,
fimaa,
ance,
air
​
franchising
string | null

Filter by franchising group name (e.g. Gabetti, Tecnocasa, RE/MAX)

Response

Successful Response

​
id
integer
required
​
@type
string
default:@immobiliare_agency_list_item
​
name
string | null
​
url
string | null
​
type
string | null
​
description
string | null
​
address
string | null
​
phone
string | null
​
image
string | null
​
association
string | null
​
listing_count
integer | null
​
sale_listing_count
integer | null
​
years_on_site
integer | null
​
quality_index
integer | null
​
badge
string | null
​
is_guaranteed
boolean | null
​
location
ImmobiliareAgencyLocation · object