{
  "openapi": "3.0.1",
  "info": {
    "title": "OpenRent Scraper | Rental Listings and Landlords",
    "description": "OpenRent scraper for UK rental listings: search by town, postcode, OpenRent link or property ID and get rent, deposit, availability, bedrooms, tenant rules, EPC rating, full postcode, coordinates, schools, photos and landlord response stats. 20 listings in 18 seconds, 41 fields each, in 2026.",
    "version": "1.0",
    "x-build-id": "5yrQrMDqXJLUerXoU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~openrent-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-openrent-scraper",
        "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/silentflow~openrent-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-openrent-scraper",
        "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/silentflow~openrent-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-openrent-scraper",
        "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": {
          "searchTerms": {
            "title": "📍 Locations",
            "type": "array",
            "description": "Places to search, typed as you would in OpenRent's search box: a city or town (<code>Manchester</code>, <code>Bristol</code>), a London area (<code>Camden</code>) or a postcode district (<code>SW18</code>, <code>M1</code>). Each place returns every listing OpenRent shows around it, nearest first. Manchester alone holds about 600 listings.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 OpenRent URLs",
            "type": "array",
            "description": "Paste OpenRent links: a search page with its filters (<code>https://www.openrent.co.uk/properties-to-rent/leeds?term=Leeds&amp;prices_max=1200&amp;isLive=true</code>), a landlord's page, or a single listing (<code>https://www.openrent.co.uk/property-to-rent/london/studio-flat-craven-street-wc2n/3007606</code>). Every filter of the OpenRent search form is kept.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "propertyIds": {
            "title": "🆔 Property IDs",
            "type": "array",
            "description": "OpenRent property references, the number at the end of a listing link or under <b>Property reference</b> on the page (<code>3007606</code>). Each returns its full listing, also when it has been let since.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max listings",
            "minimum": 1,
            "type": "integer",
            "description": "How many listings to save in total, across all locations, links and IDs. Set it to what you need: the run stops there. With full details on, the first few dozen listings arrive within seconds and the rest at a steady pace, so a few hundred take minutes; with details off, runs read 20 listings at a time.",
            "default": 100
          },
          "minPrice": {
            "title": "💷 Min rent (£ per month)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest monthly rent to keep, in pounds per calendar month (pcm), e.g. <code>800</code>."
          },
          "maxPrice": {
            "title": "💷 Max rent (£ per month)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest monthly rent to keep, in pounds per calendar month (pcm), e.g. <code>1500</code>."
          },
          "minBedrooms": {
            "title": "🛏️ Min bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Keep listings with at least this many bedrooms, e.g. <code>2</code>. A room in a shared house counts the bedrooms of the whole house."
          },
          "propertyType": {
            "title": "🏠 Property type",
            "enum": [
              "any",
              "flat",
              "house",
              "room"
            ],
            "type": "string",
            "description": "Keep only flats (studios included), houses, or rooms in shared homes.",
            "default": "any"
          },
          "sort": {
            "title": "↕️ Sort by",
            "enum": [
              "distance",
              "newest",
              "price_low",
              "price_high"
            ],
            "type": "string",
            "description": "Which listings come first when <b>Max listings</b> stops the run: the nearest to the place searched, the newest on OpenRent, or by rent.",
            "default": "distance"
          },
          "includeDetails": {
            "title": "📄 Full listing details",
            "type": "boolean",
            "description": "On: each row carries the full listing page: complete description, deposit, EPC rating, smokers, max tenants, full postcode, nearby stations and schools, every photo, video tour and the landlord's response rate and time. Off: a faster run with the search data only (rent, bedrooms, tenant rules, coordinates, first lines of the description).",
            "default": true
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}