Skip to main content
POST
/
api
/
fotocasa
/
agencies
/
search
/fotocasa/agencies/search
curl --request POST \
  --url https://api.anysite.io/api/fotocasa/agencies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "province": "<string>",
  "count": 2,
  "timeout": 300,
  "offer_type": "venta"
}
'
[
  {
    "client_id": "<string>",
    "@type": "@fotocasa_agency",
    "name": "<string>",
    "alias": "<string>",
    "url": "<string>",
    "image": "<string>",
    "listing_in_zone_count": 123,
    "listing_count": 123,
    "lowest_price": 123
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
province
string
required

Province or municipality to list agencies in

Minimum string length: 1
Examples:

"Madrid"

"Barcelona"

"Valencia"

​
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
​
offer_type
enum<string>
default:venta

Offer type the agency publishes

Available options:
venta,
alquiler

Response

Successful Response

​
client_id
string
required
​
@type
string
default:@fotocasa_agency
​
name
string | null
​
alias
string | null
​
url
string | null
​
image
string | null
​
listing_in_zone_count
integer | null
​
listing_count
integer | null
​
lowest_price
integer | null