Skip to main content
POST
/
api
/
fotocasa
/
agencies
/
listings
/fotocasa/agencies/listings
curl --request POST \
  --url https://api.anysite.io/api/fotocasa/agencies/listings \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "client_id": "<string>",
  "count": 2,
  "timeout": 300,
  "transaction": "comprar",
  "min_price": 1,
  "max_price": 1,
  "min_surface": 1,
  "max_surface": 1,
  "min_rooms": 1,
  "max_rooms": 1,
  "min_bathrooms": 1
}
'
[
  {
    "@type": "@fotocasa_agency_listings",
    "agency": {
      "client_id": "<string>",
      "@type": "@fotocasa_agency_profile",
      "name": "<string>",
      "alias": "<string>",
      "description": "<string>",
      "email": "<string>",
      "phones": [],
      "web": "<string>",
      "web_domain": "<string>",
      "address": "<string>",
      "address_url": "<string>",
      "town": "<string>",
      "province": "<string>",
      "zip_code": "<string>",
      "coordinates": {
        "@type": "@fotocasa_coordinates",
        "latitude": 123,
        "longitude": 123
      },
      "image": "<string>",
      "has_quality_seal": true,
      "agent_count": 123,
      "franchisee_count": 123,
      "created_at": "<string>",
      "publisher_id": "<string>"
    },
    "listings": []
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
client_id
string
required

Numeric Fotocasa agency client id

Minimum string length: 1
Examples:

"9202765062251"

"900140000987"

​
count
integer
required

Max number of agency listings to return

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
transaction
enum<string>
default:comprar

Transaction type of the listings

Available options:
comprar,
alquiler
​
min_price
integer | null

Minimum price filter

Required range: x >= 0
​
max_price
integer | null

Maximum price filter

Required range: x >= 0
​
min_surface
integer | null

Minimum surface filter in m²

Required range: x >= 0
​
max_surface
integer | null

Maximum surface filter in m²

Required range: x >= 0
​
min_rooms
integer | null

Minimum number of rooms filter

Required range: x >= 0
​
max_rooms
integer | null

Maximum number of rooms filter

Required range: x >= 0
​
min_bathrooms
integer | null

Minimum number of bathrooms filter

Required range: x >= 0

Response

Successful Response

​
@type
string
default:@fotocasa_agency_listings
​
agency
FotocasaAgencyProfile · object
​
listings
FotocasaPropertyCard · object[]