{
  "openapi": "3.0.1",
  "info": {
    "title": "Rightmove Market Intelligence — Property & Agent Data",
    "description": "Analyze Rightmove buy, rent, sold-price, and estate-agent data for UK investment research, comparables, yields, pricing, and agent competition. Not for owner identity or regulated valuations. Returns structured property, sold, agent, and market-summary records. $0.005/record + $0.25/report.",
    "version": "1.1",
    "x-build-id": "IlaVQWzJQdxUsThkz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/muhammadafzal~rightmove-market-intelligence/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-muhammadafzal-rightmove-market-intelligence",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/muhammadafzal~rightmove-market-intelligence/runs": {
      "post": {
        "operationId": "runs-sync-muhammadafzal-rightmove-market-intelligence",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/muhammadafzal~rightmove-market-intelligence/run-sync": {
      "post": {
        "operationId": "run-sync-muhammadafzal-rightmove-market-intelligence",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "locations": {
            "title": "UK locations",
            "minItems": 1,
            "maxItems": 10,
            "type": "array",
            "description": "Use this when analyzing one or more UK areas by town, postcode, or neighbourhood. Enter one value per line, for example 'Manchester' or 'SW19'. Defaults to London and accepts 1-10 locations. This is not a property URL; use Start URLs for exact Rightmove searches.",
            "items": {
              "type": "string"
            },
            "default": [
              "London"
            ]
          },
          "startUrls": {
            "title": "Rightmove start URLs",
            "type": "array",
            "description": "Use this when you already have Rightmove search, listing, sold-price, or agent-directory URLs. Enter objects such as {\"url\":\"https://www.rightmove.co.uk/property-for-sale/find.html?locationIdentifier=REGION%5E87490\"}. Defaults to an empty list and overrides UK locations when provided. URLs from other hosts are rejected.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "dataTypes": {
            "title": "Market data types",
            "type": "array",
            "description": "Use this when choosing which Rightmove markets to analyze. Select any of BUY, RENT, SOLD, and AGENT; for example ['BUY','RENT']. Defaults to all four types. This does not change the type inferred from a supplied Start URL.",
            "items": {
              "type": "string",
              "enum": [
                "BUY",
                "RENT",
                "SOLD",
                "AGENT"
              ],
              "enumTitles": [
                "Properties for sale",
                "Properties to rent",
                "Sold house prices",
                "Estate and letting agents"
              ]
            },
            "default": [
              "BUY",
              "RENT",
              "SOLD",
              "AGENT"
            ]
          },
          "maxResultsPerType": {
            "title": "Maximum records per type",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Use this to cap records separately for each selected market type and location. Enter an integer such as 25. Defaults to 25 and accepts 1-500. This is not the combined run total; four types across two locations can return up to eight times this value.",
            "default": 25
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to exclude listings below a GBP amount. Enter a whole number such as 200000; rental values are monthly PCM. Defaults to 0, meaning no lower bound. This filter does not apply to sold-price history or agent records.",
            "default": 0
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to exclude listings above a GBP amount. Enter a whole number such as 750000; rental values are monthly PCM. Defaults to 0, meaning no upper bound. This filter does not apply to sold-price history or agent records.",
            "default": 0
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Use this to set the minimum bedroom count for sale and rental searches. Enter an integer such as 2. Defaults to 0, meaning any count, and accepts 0-10. This filter does not apply to sold-price or agent searches.",
            "default": 0
          },
          "maxBedrooms": {
            "title": "Maximum bedrooms",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Use this to set the maximum bedroom count for sale and rental searches. Enter an integer such as 4. Defaults to 0, meaning any count, and accepts 0-10. This filter does not apply to sold-price or agent searches.",
            "default": 0
          },
          "radius": {
            "title": "Search radius",
            "enum": [
              "0.0",
              "0.25",
              "0.5",
              "1.0",
              "3.0",
              "5.0",
              "10.0",
              "15.0",
              "20.0",
              "30.0",
              "40.0"
            ],
            "type": "string",
            "description": "Use this to widen property and agent searches around the resolved location. Select a mile radius such as '1.0'. Defaults to '0.0', meaning this area only. This is not a map bounding box and does not affect supplied Start URLs.",
            "default": "0.0"
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Use this to restrict sale and rental listings to specific property classes. Select values such as ['flat','terraced']. Defaults to an empty list, meaning every type. This filter does not classify sold-price or agent records.",
            "items": {
              "type": "string",
              "enum": [
                "detached",
                "semi-detached",
                "terraced",
                "flat",
                "bungalow",
                "land",
                "park-home"
              ]
            },
            "default": []
          },
          "addedToSite": {
            "title": "Added to Rightmove",
            "enum": [
              "anytime",
              "1",
              "3",
              "7",
              "14"
            ],
            "type": "string",
            "description": "Use this to limit sale and rental listings by freshness. Select '3' for properties added in the last three days. Defaults to 'anytime'. This filter does not represent days on market and does not affect sold or agent records.",
            "default": "anytime"
          },
          "includeUnderOffer": {
            "title": "Include under-offer listings",
            "type": "boolean",
            "description": "Use this to include Sold STC, under-offer, and let-agreed listings in live searches. Set false to keep only currently available stock. Defaults to true. This option does not convert live listings into completed sold transactions.",
            "default": true
          },
          "enrichDetails": {
            "title": "Enrich property details",
            "type": "boolean",
            "description": "Use this when floor area, tenure, EPC, descriptions, and listing history improve the analysis. Set true to open each sale or rental property page. Defaults to true and increases runtime without changing the per-record event price. This option does not download or republish photos and floorplans.",
            "default": true
          },
          "includeMarketReport": {
            "title": "Create market report",
            "type": "boolean",
            "description": "Use this when you need aggregate investment and competition metrics in addition to raw records. Set true to create one compact report per run. Defaults to true and adds one $0.25 report event. This is analytical research, not a regulated valuation or investment recommendation.",
            "default": true
          },
          "responseFormat": {
            "title": "Response detail",
            "enum": [
              "concise",
              "detailed"
            ],
            "type": "string",
            "description": "Use this to control text richness while keeping the same stable field set. Choose 'concise' for AI-agent workflows or 'detailed' for longer descriptions and feature lists. Defaults to 'concise'. This does not change record count or pricing.",
            "default": "concise"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Use this only when direct requests are blocked or your workload requires a specific proxy pool. Direct HTTP is the reliable default and incurs no proxy transfer charge. If enabled, choose groups and country access available on your Apify plan; an unavailable country pool can return HTTP 407.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}