{ "openapi": "3.0.1", "info": { "title": "Redfin Scraper: Homes for Sale, Sold Comps, Agents", "description": "Pull Redfin listings into a sheet: active, coming soon, pending, sold comps and rentals for a city, ZIP code, school district, link or map area, no login. Rows carry MLS number, list price, sq ft, HOA and photos; add the Redfin Estimate, Walk Score, flood risk or agents. Pay per home, CSV or API.", "version": "0.1", "x-build-id": "f7wl3xA1Bqvr0ClYK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~redfin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-redfin-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/automation_craft~redfin-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-redfin-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/automation_craft~redfin-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-redfin-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": { "locations": { "title": "Places (city, ZIP code, county, neighborhood, state)", "type": "array", "description": "Places as Redfin names them, one per line: \"Austin, TX\", \"78704\", \"Travis County, TX\", \"Hyde Park, Austin, TX\", \"Texas\" (a state is read county by county) or a school district (\"Austin Independent School District\"). A place is searched only when exactly one Redfin region is that text; otherwise a free row lists the regions to pick from.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Five digit ZIP codes, one per line (each is read as its Redfin ZIP region).", "items": { "type": "string" } }, "regionIds": { "title": "Redfin region ids", "type": "array", "description": "Regions by Redfin's own id, written \":\": city:30818, county:2866, neighborhood:172898, zip:34098 (Redfin's ZIP region id, not the ZIP code), state:36, school:263366, school-district:5816, minor-civil-division:250. Ids are in the place lookup rows and in Redfin links. An id Redfin does not know is a free row.", "items": { "type": "string" } }, "startUrls": { "title": "Redfin links (searches, homes, agents, short links)", "type": "array", "description": "Links copied from Redfin: a search page (city, ZIP, county, neighborhood, state, school district; with its /filter/ part, a sold search with include=sold-3mo, a rentals page, a map view), a home, an agent profile or a short link (redf.in). An entry may be { \"url\": ..., \"maxItems\": 50 } to cap that link, or { \"requestsFromUrl\": \"https://.../links.csv\" } for a text or CSV file of links (a filter link alone on its line or in quotes). A link part the Actor does not read is a free row, never a guess.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "mapAreas": { "title": "Map areas", "type": "array", "description": "Areas on the map, each one of: { \"latitude\": 30.27, \"longitude\": -97.74, \"radiusMiles\": 2 } (a circle, 0.1 to 50 miles), { \"north\": 30.3, \"south\": 30.2, \"east\": -97.7, \"west\": -97.8 } (a box) or { \"polygon\": [[30.2, -97.8], [30.3, -97.8], [30.3, -97.7]] } (3 to 200 points of latitude and longitude). Only homes inside are delivered." }, "propertyIds": { "title": "Property ids (home lookups)", "type": "array", "description": "Redfin property ids (the number at the end of a home link), one per line. Each home is delivered as Redfin shows it (for sale, sold, pending or off market), search settings do not apply.", "items": { "type": "string" } }, "addresses": { "title": "Street addresses (home lookups)", "type": "array", "description": "US street addresses with city and state, one per line (\"904 Avondale Rd, Austin, TX 78704\"). An address Redfin's address search does not hold exactly is a free row with the nearest matches.", "items": { "type": "string" } }, "listingStatus": { "title": "Listing status", "enum": [ "forSale", "sold", "forRent" ], "type": "string", "description": "The status of every place, ZIP code, region id and map area search: for sale, recently sold or for rent. Search links keep their own. Default: for sale." }, "forSaleStatuses": { "title": "For sale: which homes", "type": "array", "description": "Homes for sale to include. Default: active and coming soon (Redfin's own default).", "items": { "type": "string", "enum": [ "active", "comingSoon", "contingent", "pending" ], "enumTitles": [ "Active", "Coming soon", "Contingent (under contract)", "Pending" ] } }, "listingTypes": { "title": "For sale: listing kinds", "type": "array", "description": "Listing kinds to include. Default: agent listed, MLS for sale by owner, for sale by owner and new construction (foreclosures left out, as on Redfin).", "items": { "type": "string", "enum": [ "agentListed", "mlsFsbo", "fsbo", "foreclosure", "newConstruction" ], "enumTitles": [ "Agent listed", "MLS for sale by owner", "For sale by owner", "Foreclosures", "New construction and plans" ] } }, "soldWithinDays": { "title": "Sold: within the last days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Recently sold homes sold within this many days (1 to 3650). Default: 90. A very large place with a long window can time out at Redfin: the coverage row says so." }, "sort": { "title": "Order", "enum": [ "newest", "oldest", "priceLow", "priceHigh", "pricePerSqftLow", "pricePerSqftHigh", "sqftLarge", "sqftSmall", "lotLarge", "lotSmall", "bedsMost", "bedsFewest", "bathsMost", "bathsFewest", "recentlySold", "earliestSold" ], "type": "string", "description": "The order homes are read and delivered in. Default: newest listings first (for sale, for rent), most recently sold first (sold). Rentals take newest, price low and price high." }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Lowest list or sale price; for rentals the lowest monthly rent." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Highest list or sale price; for rentals the highest monthly rent." }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "At least this many bedrooms (0 = studios too)." }, "maxBeds": { "title": "Maximum bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "At most this many bedrooms (homes for sale and sold)." }, "minBaths": { "title": "Minimum bathrooms", "minimum": 0, "maximum": 20, "type": "number", "description": "At least this many bathrooms (1, 1.5, 2, ...)." }, "homeTypes": { "title": "Home types", "type": "array", "description": "For sale and sold: house, condo, townhouse, multi family, land, other, manufactured, co-op (\"other\" also returns manufactured homes, as on Redfin). For rent: house, condo, townhouse, apartment.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multiFamily", "land", "other", "manufactured", "coop", "apartment" ], "enumTitles": [ "House", "Condo", "Townhouse", "Multi family", "Land", "Other", "Manufactured", "Co-op", "Apartment (rentals)" ] } }, "minSqft": { "title": "Minimum living area (sq ft)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "At least this many square feet of living area." }, "maxSqft": { "title": "Maximum living area (sq ft)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "At most this many square feet (homes for sale and sold)." }, "minLotSqft": { "title": "Minimum lot (sq ft)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Lot at least this many square feet (43560 = 1 acre)." }, "maxLotSqft": { "title": "Maximum lot (sq ft)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Lot at most this many square feet." }, "minYearBuilt": { "title": "Built in or after", "minimum": 1600, "maximum": 2100, "type": "integer", "description": "Year built at least." }, "maxYearBuilt": { "title": "Built in or before", "minimum": 1600, "maximum": 2100, "type": "integer", "description": "Year built at most." }, "minStories": { "title": "Minimum stories", "minimum": 1, "maximum": 50, "type": "integer", "description": "At least this many stories." }, "maxStories": { "title": "Maximum stories", "minimum": 1, "maximum": 50, "type": "integer", "description": "At most this many stories (1 = single story homes)." }, "maxHoa": { "title": "Maximum HOA (USD a month)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Monthly HOA dues at most this much; 0 = homes with no HOA." }, "minPricePerSqft": { "title": "Minimum price per sq ft (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Price per square foot at least." }, "maxPricePerSqft": { "title": "Maximum price per sq ft (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Price per square foot at most." }, "maxPropertyTax": { "title": "Maximum property tax (USD a year)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Yearly property tax at most." }, "minParking": { "title": "Minimum parking spaces", "minimum": 1, "maximum": 20, "type": "integer", "description": "At least this many parking spaces." }, "garage": { "title": "Has a garage", "type": "boolean", "description": "Only homes with a garage." }, "pool": { "title": "Pool", "enum": [ "any", "private", "community", "privateOrCommunity", "noPrivatePool" ], "type": "string", "description": "Any pool, a private pool, a community pool, either, or homes without a private pool." }, "waterfront": { "title": "Waterfront", "type": "boolean", "description": "Only waterfront homes." }, "view": { "title": "Has a view", "type": "boolean", "description": "Only homes with a view." }, "fireplace": { "title": "Fireplace", "type": "boolean", "description": "Only homes with a fireplace." }, "airConditioning": { "title": "Air conditioning", "type": "boolean", "description": "Only homes with air conditioning." }, "washerDryerHookup": { "title": "Washer and dryer hookup", "type": "boolean", "description": "Only homes with a washer and dryer hookup." }, "accessible": { "title": "Accessible home", "type": "boolean", "description": "Only homes marked accessible." }, "elevator": { "title": "Elevator", "type": "boolean", "description": "Only homes with an elevator." }, "green": { "title": "Green home", "type": "boolean", "description": "Only homes with green or energy efficient features." }, "guestHouse": { "title": "Guest house", "type": "boolean", "description": "Only homes with a guest house." }, "primaryBedroomOnMain": { "title": "Primary bedroom on main floor", "type": "boolean", "description": "Only homes with the primary bedroom on the main floor." }, "rvParking": { "title": "RV parking", "type": "boolean", "description": "Only homes with RV parking." }, "fixerUpper": { "title": "Fixer upper", "type": "boolean", "description": "Only fixer uppers." }, "openHouse": { "title": "Open house", "enum": [ "anytime", "thisWeekend" ], "type": "string", "description": "Only homes with an open house: any time or this weekend." }, "virtualTour": { "title": "Virtual tour", "type": "boolean", "description": "Only homes with a virtual tour." }, "priceReducedWithinDays": { "title": "Price reduced within the last days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only homes whose price was reduced within this many days (for sale)." }, "maxDaysOnMarket": { "title": "Maximum days on market", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Listed at most this many days ago (for sale)." }, "minDaysOnMarket": { "title": "Minimum days on market", "minimum": 1, "maximum": 3650, "type": "integer", "description": "On the market at least this many days (for sale)." }, "financing": { "title": "Financing", "enum": [ "fha", "va" ], "type": "string", "description": "Only homes eligible for FHA or VA financing." }, "minWalkScore": { "title": "Minimum Walk Score", "minimum": 1, "maximum": 100, "type": "integer", "description": "Walk Score at least (1 to 100)." }, "minBikeScore": { "title": "Minimum Bike Score", "minimum": 1, "maximum": 100, "type": "integer", "description": "Bike Score at least (1 to 100)." }, "minTransitScore": { "title": "Minimum Transit Score", "minimum": 1, "maximum": 100, "type": "integer", "description": "Transit Score at least (1 to 100)." }, "redfinListingsOnly": { "title": "Redfin listings only", "type": "boolean", "description": "Only homes listed by Redfin agents." }, "excludeShortSales": { "title": "Exclude short sales", "type": "boolean", "description": "Leave short sales out." }, "excludeAgeRestricted": { "title": "Exclude 55+ communities", "type": "boolean", "description": "Leave age restricted (55+) communities out." }, "keywords": { "title": "Keywords in the description", "type": "string", "description": "Words Redfin matches in the listing description, for example \"guest house\" (Redfin matches the full description; rows show the first 699 characters of it)." }, "dogsAllowed": { "title": "Rentals: dogs allowed", "type": "boolean", "description": "Only rentals that allow dogs." }, "catsAllowed": { "title": "Rentals: cats allowed", "type": "boolean", "description": "Only rentals that allow cats." }, "inUnitLaundry": { "title": "Rentals: in-unit laundry", "type": "boolean", "description": "Only rentals with a washer and dryer in the unit." }, "parking": { "title": "Rentals: parking", "type": "boolean", "description": "Only rentals with parking." }, "furnished": { "title": "Rentals: furnished", "type": "boolean", "description": "Only furnished rentals." }, "moveInBy": { "title": "Rentals: move in by", "type": "string", "description": "Only rentals available to move in on or before this date (YYYY-MM-DD)." }, "maxItems": { "title": "Maximum rows (whole run)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many paid rows in all (homes and agents). Status, coverage and summary rows are free and not counted. Default: 1,000." }, "maxItemsPerSearch": { "title": "Maximum rows per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop each search (and each agent location) after this many rows. A link entry's own \"maxItems\" wins for that link." }, "includeDetails": { "title": "Home details (add-on)", "type": "boolean", "description": "Adds each home's Redfin record, charged as a Home details event: price and tax history, public records, amenities, listing agent and broker, the Redfin Estimate and its 5 year history, rent estimate, schools, Walk Score, location scores, flood, fire, heat, wind and air risk, permits, zoning, parcel, page views, comparable sales, market competition, sun exposure; for rentals the floor plans, units, amenities and policies. Charged only when every chosen section was read." }, "detailSections": { "title": "Home details: sections", "type": "array", "description": "The sections Home details reads (all by default). Fewer sections read faster; the price is the same.", "items": { "type": "string", "enum": [ "history", "publicRecords", "amenities", "listingAgent", "estimate", "schools", "walkScore", "risk", "permits", "parcel", "zoning", "views", "comparables", "marketCompetition", "sunExposure", "locationScores", "rentEstimate", "banner", "highlights" ], "enumTitles": [ "Price history", "Public records and tax history", "Amenities", "Listing agent and broker", "Redfin Estimate and its history", "Schools", "Walk, Transit and Bike Score", "Flood, fire, heat, wind and air risk", "Building permits", "Parcel (APN, FIPS, outline)", "Zoning", "Page views", "Comparable sold homes", "Market competition", "Sun exposure", "Location scores", "Rent estimate", "Listing banner", "Highlights" ] } }, "maxPhotos": { "title": "Maximum photo links per home", "minimum": 0, "maximum": 500, "type": "integer", "description": "Cap the photo links a row carries (0 = none). Default: every photo." }, "agentLocations": { "title": "Agents: places (city, ZIP code, county, state)", "type": "array", "description": "Places whose Redfin agent list to deliver (Redfin agents and partner agents), one per line: \"Austin, TX\", \"78704\", \"Travis County, TX\", or a state (\"Delaware\", read county by county). Each agent is an Agent row.", "items": { "type": "string" } }, "includeAgentDetails": { "title": "Agent details (add-on)", "type": "boolean", "description": "Adds each agent's profile, charged as an Agent details event on top of the Agent: total deals, response time, service regions, review counts by stars, the latest reviews with their text, deal statistics of the last year and lifetime, recent sales and purchases. Charged only when every part was read." }, "agentTypes": { "title": "Agents: kinds", "type": "array", "description": "Redfin agents, partner agents of other brokerages, or both (default).", "items": { "type": "string", "enum": [ "redfin", "partner" ], "enumTitles": [ "Redfin agents", "Partner agents" ] } }, "agentsWithEmailOnly": { "title": "Agents: with an e-mail only", "type": "boolean", "description": "Only agents whose e-mail Redfin shows." }, "agentsWithPhoneOnly": { "title": "Agents: with a phone only", "type": "boolean", "description": "Only agents whose phone Redfin shows." }, "agentBrokerage": { "title": "Agents: brokerage", "type": "string", "description": "Only agents whose brokerage name holds these words, for example \"Compass\"." }, "minAgentRating": { "title": "Agents: minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only agents rated at least this (0 to 5 stars)." }, "minAgentDeals": { "title": "Agents: minimum deals in the past year", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only agents with at least this many deals in the past year." }, "includePersonalData": { "title": "Include personal data (agents and private sellers)", "type": "boolean", "description": "Off by default. On, rows also carry agents' names, e-mails, phones, photos, profile links and ids, the listing agent's name and phone, review customers' names, the street, link and id of an agent's deal homes, a non building rental's contact, and for a home sold or let by its owner its street, position, link and risk report link. Texts (remarks, reviews) always come as written. You are responsible for lawful use (GDPR, CAN-SPAM, TCPA)." }, "outputFields": { "title": "Fields to keep", "type": "array", "description": "Keep only these fields of each row (names as in the output, nested ones with a dot: \"address.zip\", \"details.estimate\"). Empty: every field.", "items": { "type": "string" } }, "excludeFields": { "title": "Fields to leave out", "type": "array", "description": "Leave these fields out of each row (names as in the output, nested ones with a dot: \"remarks\", \"details.schools\"); every other field is kept. Use it or \"outputFields\", not both.", "items": { "type": "string" } }, "flattenOutput": { "title": "Flatten rows", "type": "boolean", "description": "Write nested fields as dotted columns (\"address.city\") for spreadsheets." }, "placeLookups": { "title": "Place lookups (free)", "type": "array", "description": "Texts to look up in Redfin's regions without searching them: each gives a free row with the matching regions and their ids (to use in \"regionIds\").", "items": { "type": "string" } }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many requests run at once (1 to 6). Default: 4." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default (datacenter). You may give your own http:// proxy links instead." } } }, "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 } } } } } } } } } }