---
title: "List Rightmove estate agents for a location"
method: GET
path: "/rightmove/agents"
tags: ["Rightmove"]
---

# List Rightmove estate agents for a location

`GET /rightmove/agents`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/rightmove/agents`
- Auth: API key in header `x-api-key`

Lists estate-agent branches from Rightmove's estate-agents directory for a location, with branch display name, brand, address, telephones, sales/lettings flags, logo, and a link to the branch profile. Pagination follows Rightmove's current directory pages, whose result counts can vary.

## Query parameters

- `location` string, required
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

Estate agent directory

- object: The Response struct is used for wrapping the API response with a code, message, and data.
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` object: Data is the response data (can be any object or null) @example {"id": 1, "name": "John Doe"}
    - `location` string
    - `page` integer
    - `results` RightmoveAgentItem[]
      - `address` string
      - `brand_name` string
      - `description` string
      - `display_name` string
      - `id` string
      - `lettings` boolean
      - `logo_url` string
      - `sales` boolean
      - `telephones` RightmoveAgentTelephone[]
        - `direct_number` string
        - `number` string
        - `type` string
      - `url` string
    - `total` integer
  - `msg` unknown

## Other responses

- `400`: Invalid query parameter
- `500`: Internal server error
- `503`: Upstream error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)