Listingrail API

Search live sale and rental listings on 17 portals and get every listing back in the same shape. Base address https://listingrail.com. The interactive reference with every request and response model is at /reference.

Quick start

Get a free key on the home page, then:

import requests

r = requests.post(
    "https://listingrail.com/v1/listings/search",
    headers={"Authorization": "Bearer " + KEY},
    json={"source": "idealista", "location": "madrid", "type": "rent", "limit": 50},
    timeout=180,
)
r.raise_for_status()
for home in r.json()["listings"]:
    print(home["price"], home["currency"], home["address"])

A search answers with the listings and your credit balance:

{
  "source": "rightmove",
  "location": "SW11",
  "count": 1,
  "credits_used": 1,
  "credits_remaining": 99,
  "listings": [
    {
      "id": "94216239",
      "url": "https://www.rightmove.co.uk/properties/94216239",
      "source": "rightmove",
      "title": "1 bedroom apartment",
      "address": "Battersea Power Station, London, SW11",
      "city": null,
      "region": null,
      "postal_code": null,
      "country": "GB",
      "lat": 51.483057,
      "lng": -0.14647,
      "price": 3683,
      "currency": "GBP",
      "price_period": "month",
      "beds": 1,
      "rooms": null,
      "baths": 1,
      "area": null,
      "area_unit": null,
      "property_type": "Apartment",
      "listed_at": "2026-10-12T16:45:35Z",
      "photos": [
        "https://media.rightmove.co.uk/property-photo/8d2f9326b/94216239/8d2f9326b00af02e053ec063a0693474.jpeg",
        "https://media.rightmove.co.uk/property-photo/490c2b8ae/94216239/490c2b8aef60695a379d4aba312b248e.jpeg"
      ],
      "agent": {
        "name": "JOHNS&CO, Nine Elms",
        "phone": "020 3907 3782",
        "company": "JOHNS&CO"
      }
    }
  ]
}

The raw object is left out above; every listing carries one.

Keys and credits

Send your key as Authorization: Bearer <key> or X-API-Key: <key>. One credit is one listing returned. A request for more listings than you have credits returns as many as your credits cover; at zero credits the API answers 402. A search that fails at the portal is not charged. Paid plans renew their credits at the start of each billing month; the free 100 credits are given once.

Endpoints

Portals

Rightmove and Idealista take no price or bedroom filters here; set them on the portal and pass the search link as location.

Listing fields

A field a portal does not show is null. Which portal fills which field is shown on the home page.

Monitors

A monitor stores a search and checks it once a day. The first check records what is listed; each later check compares by listing id and reports new listings, listings that are gone, and price changes. Each check costs one credit per listing it reads. A free key or Starter holds 1 monitor, Pro 3, Scale 10; the monitor plans hold 3 and 20 and come with a dashboard to read and export the changes.

{
  "source": "zumper",
  "location": "Austin, TX",
  "filters": {
    "type": "rent",
    "maxPrice": 2000,
    "limit": 50
  },
  "webhook_url": "https://you.example/hooks/listings"
}

When something changed, the report is also POSTed to webhook_url (public https addresses only). A check that returns fewer listings than the last one reports the missing ones as removed, so keep limit above the number of listings the search usually has.

Errors

Limits

• Up to 500 listings per request. Larger pulls: page by price range or area, or ask about a delivered dataset.
• Requests can take up to two minutes on large searches; set your client timeout to 180 seconds.
• Listings are what each portal shows a visitor at request time. Results and order can differ between two requests.