Rightmove

Rightmove Agents API

Estate and letting agent branches on Rightmove for a UK location: name, brand, company and brand ids, sales and lettings phone numbers, address, sales and lettings flags, description, profile URL and logo. 20 branches per page, up to 50 pages. Costs 1 credit per request.

POST/api/v1/rightmove/agents

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

location_idstring

A location_id from Locations. Pass exactly one of location_id or location.

Example: REGION^219

locationstring

A place name, resolved to its first location match and echoed back in data.location.

Example: Bristol

pageintegerdefault:1

Results page, 1-50 (20 branches per page). Stop at max_page.

Example: 2

Notes

50 pages per search. Rightmove serves 50 pages of 20 branches per agent search. In a big city that is not every branch; search by outcode (for example OUTCODE^ ids from Locations) to reach the rest. branch_id feeds Agent and the branch_id filter on Search.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.rightmove.agents(location_id="REGION^219")

for a in res["data"]["agents"]:
    print(a["branch_id"], a["name"], a["sales"], a["lettings"], a["phones"])

Response

"total": 253,

"count": 20,

"page": 1,

"max_page": 13,

"response_time": 1180

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.rightmove.agents(location_id="REGION^219") for a in res["data"]["agents"]: print(a["branch_id"], a["name"], a["sales"], a["lettings"], a["phones"])