{ "openapi": "3.0.1", "info": { "title": "RentHop Scraper [Only $3.5💰] | NYC Rentals | Broker Data", "description": "Scrape RentHop rental listings for apartment market research and broker lead generation: rent, beds and baths, square footage, address, neighborhood and ZIP, no-fee flag, broker name and phone, photos and description.", "version": "0.0", "x-build-id": "2IDsIdXoTEX7faSxM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~renthop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-renthop-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/ahmed_jasarevic~renthop-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-renthop-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/ahmed_jasarevic~renthop-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-renthop-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "RentHop search URLs (e.g. https://www.renthop.com/apartments-for-rent/new-york-ny/2-bedroom) or direct listing URLs (https://www.renthop.com/listings/...). Defaults to 2-bedroom apartments in New York, NY.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxListings": { "title": "Max listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to return. The Actor stops as soon as this many listings have been pushed.", "default": 30 }, "maxPagesPerSearch": { "title": "Max pages per search URL", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many result pages to crawl for each search URL (each page yields roughly 15 unique listings). This is a floor, not a ceiling: the Actor raises it on its own whenever maxListings needs more pages than this, so a run never stops short of the requested count. Each page is fetched on its own verified residential IP, which then walks its own listings at RentHop's limit of about one request per 2.5 s, so more pages also means more verified IPs working in parallel — raise it yourself only to force that extra parallelism.", "default": 1 }, "enrichDetails": { "title": "Enrich with listing detail pages", "type": "boolean", "description": "Visit every listing page to add the exact address/unit, full description, all photos, precise beds/baths/square footage and the broker's phone number — the broker writes it into the listing description, so it comes along with the same request. Off by default: the search page already returns rent, address, zip, beds, baths, coordinates, tags, broker and thumbnail in a single request, which is what makes a run finish in seconds. Turning this on adds one request per listing, so a 20-listing run goes from ~2 requests to ~28 and takes 35-85 s instead of ~9 s.", "default": false }, "maxConcurrency": { "title": "Parallel page fetches", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages to fetch at the same time. Listings found on a search page are enriched on that same page's connection, so for a normal run this mainly caps how many search pages are crawled in parallel — set it to at least maxPagesPerSearch. 5 is a good default; 1-2 if you are not using a proxy.", "default": 5 }, "requestDelayMs": { "title": "Min delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Starting gap between request starts, in milliseconds. Leave unset: the Actor derives it from maxConcurrency (about 2.5 s per IP, which is the measured RentHop limit) and then adapts it automatically — it doubles the gap whenever Cloudflare answers 403 and decays it back after clean responses. Set it only to force a slower or faster start." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxies used by the crawler. Defaults to Apify RESIDENTIAL proxies pinned to the US, which is what avoids the Cloudflare challenge: RentHop blocks detail pages from datacenter IPs and from non-US residential exits. Turning the proxy off uses the Apify cloud IP and usually returns search-card data only (no description, photos or broker phone)." } } }, "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 } } } } } } } } } }