# Auction.com $1💰 URL Search | Keyword Filtering | Rich Output (`abotapi/auction-com-scraper`) Actor From $1/1K. Extract foreclosure, REO, short-sale, and auction listings from Auction.com in minutes. Search by location and property filters or paste any Auction.com URL. Get 45+ structured fields, including auction dates, bids, estimated values, occupancy status, coordinates, and photos. - **URL**: https://apify.com/abotapi/auction-com-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Auction.com Property Scraper Collect foreclosure, bank-owned (REO), short-sale and private-seller auction listings from Auction.com in minutes. Search by state, city, ZIP, property type, asset type, beds, baths, square footage and price, or paste any Auction.com search URL. Every listing comes back with 45+ structured fields including auction dates, starting bids, estimated value, occupancy, coordinates and photos. ### Why this scraper - **Two input modes.** Build a query from structured filters, or paste one or more Auction.com URLs. Multiple URLs are supported in a single run. - **45+ fields per listing**, well past the typical 30-field offering: auction window, starting bid, estimated resale value, occupancy status, financing and buyer-premium flags, beds/baths/sqft, lot size, year built, latitude/longitude, photos and more. - **Deep pagination.** Walks far past the website's on-screen display cap using offset paging, so large states return thousands of properties in one run. - **Optional full-detail mode.** Turn on `fetchDetails` for complete auction terms, financing preference, deposit and earnest-money minimums, leaseback terms and days-to-close per listing (plus any extra media the listing exposes). - **Fast and lightweight.** Reads structured data directly, so runs finish quickly and cheaply on the default Apify datacenter proxy. No residential proxy required. - **Multi-state and multi-URL** in a single run, with automatic de-duplication. ### Data you get > Sample shape: values are illustrative placeholders, not from a live listing. | Field | Example | |---|---| | listingId | `00000001` | | url | `https://www.auction.com/details/123-sample-st-city-st-00000001` | | address | `123 Sample St, Springfield, ST 00000, Sample County` | | city / state / zip | `Springfield` / `ST` / `00000` | | county | `Sample County` | | latitude / longitude | `38.0000` / `-90.0000` | | propertyTypeGroup | `SINGLE_FAMILY` | | assetType | `BANK_OWNED` | | listingStatusGroup | `ACTIVE` | | bedrooms / bathrooms | `3` / `2` | | squareFootage | `1800` | | lotSize | `0.25` | | yearBuilt | `1995` | | startingBid | `150000` | | estimatedValue | `225000` (property value estimate) | | rentalEstimate | `1800` (monthly rent estimate) | | auctionType | `ONLINE` | | auctionStartDate | `2026-01-01T00:00:00Z` | | auctionEndDate | `2026-01-03T00:00:00Z` | | occupancyStatus | `VACANT` | | financingAvailable | `true` | | buyerPremiumAvailable | `false` | | isRemoteBidEnabled | `true` | | primaryPhoto | `https://adc-tenbox-prod.imgix.net/resi/property_image/0000000-1-G.v4.jpg` | | photoCount | `12` | | financePreference (detail mode) | `CASH` | | daysToClose (detail mode) | `30` | | earnestMoneyDepositMinimum (detail mode) | `5000` | Plus marketing tags, open houses, trustee-sale flags, valuation bands, and the complete source record under `raw` for any field not surfaced flat. ### How to use Search a single state for active listings: ```json { "mode": "search", "states": ["CA"], "listingStatus": "active", "maxPages": 5, "maxListings": 200 } ```` Search with filters (condos and townhouses, 3+ beds, under 300k, in two states): ```json { "mode": "search", "states": ["TX", "FL"], "propertyTypes": ["condos-townhouses"], "minBeds": 3, "maxPrice": 300000, "sortBy": "price-asc", "maxListings": 500 } ``` Bank-owned, online auctions, with full details: ```json { "mode": "search", "states": ["GA"], "assetTypes": ["bank-owned"], "auctionFormats": ["online"], "fetchDetails": true, "maxListings": 100 } ``` Paste Auction.com URLs (apply filters on the website, then copy the URL): ```json { "mode": "url", "urls": [ "https://www.auction.com/residential/CA/active_lt/single-family_pt", "https://www.auction.com/residential/TX/active_lt" ], "maxPages": 3 } ``` ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | mode | string | `search` | `search` (use filters) or `url` (paste links) | | states | array | `["CA"]` | Two-letter US state codes | | city | string | | City name to narrow the search | | zipCodes | array | | List of 5-digit ZIP codes | | keyword | string | | Free-text search across street, city, state, ZIP | | listingStatus | string | `active` | `active` or `sold` | | propertyTypes | array | | `single-family`, `condos-townhouses`, `multi-family`, `land` | | assetTypes | array | | `bank-owned`, `foreclosures`, `short-sales`, `private-seller` | | auctionFormats | array | | `online`, `in-person`, `remote-bid` | | minBeds / maxBeds | integer | | Bedroom range | | minBaths | integer | | Minimum bathrooms | | minSqft / maxSqft | integer | | Living area range in square feet | | minPrice / maxPrice | integer | | Starting bid range in USD | | sortBy | string | `default` | Sort order | | urls | array | | Auction.com URLs (URL mode) | | fetchDetails | boolean | `false` | Fetch the full gallery and terms per listing | | maxPages | integer | `5` | Pages per search (100 listings per page) | | maxListings | integer | `20` | Total cap (max 1,000,000); 0 means unlimited | | proxy | object | Apify datacenter | Proxy configuration | ### Output example > Sample shape: values are illustrative placeholders, not from a live listing. ```json { "listingId": "00000001", "url": "https://www.auction.com/details/123-sample-st-springfield-st-00000001", "address": "123 Sample St, Springfield, ST 00000, Sample County", "city": "Springfield", "state": "ST", "zip": "00000", "county": "Sample County", "latitude": 38.0000, "longitude": -90.0000, "propertyTypeGroup": "SINGLE_FAMILY", "assetType": "BANK_OWNED", "productType": "REO", "occupancyStatus": "VACANT", "listingStatusGroup": "ACTIVE", "bedrooms": 3, "bathrooms": 2, "squareFootage": 1800, "lotSize": 0.25, "yearBuilt": 1995, "startingBid": 150000, "estimatedValue": 225000, "estimatedValueLow": 210000, "estimatedValueHigh": 240000, "auctionType": "ONLINE", "auctionStartDate": "2026-01-01T00:00:00Z", "auctionEndDate": "2026-01-03T00:00:00Z", "financingAvailable": true, "buyerPremiumAvailable": false, "isRemoteBidEnabled": true, "primaryPhoto": "https://adc-tenbox-prod.imgix.net/resi/property_image/0000000-1-G.v4.jpg", "photoCount": 12, "marketingTags": [], "scrapedAt": "2026-01-01T00:00:00Z" } ``` ### Plan requirement This scraper runs on the default Apify datacenter proxy, so it works on the free plan for small runs. For large runs and faster throughput, any paid plan gives more compute and proxy bandwidth. Residential proxy is optional and not required for this source. If you do select residential, the run rotates a US/CA exit pool (a fresh session per attempt, and any explicit country pin is respected) and automatically fails over to a backup connection pool after repeated failures, so a single flagged exit IP will not stall the run. Free accounts should keep `maxListings` modest; paid accounts can set it to 0 for unlimited. # Actor input Schema ## `mode` (type: `string`): How to find listings. 'search' builds the query from the filter fields below. 'url' takes one or more Auction.com search URLs you paste. ## `states` (type: `array`): Two-letter US state codes to search, e.g. CA, TX, FL. Leave empty to search nationwide. ## `city` (type: `string`): Optional city name to narrow the search, e.g. Los Angeles. Combine with a single state for best results. ## `zipCodes` (type: `array`): Optional list of 5-digit ZIP codes to narrow the search. ## `keyword` (type: `string`): Optional free-text search across street, city, state and ZIP, e.g. 'Main St' or '90210'. ## `listingStatus` (type: `string`): Active listings open for bidding, or sold/closed listings. ## `propertyTypes` (type: `array`): Filter by property category. Leave empty for all. ## `assetTypes` (type: `array`): Filter by distressed-asset category. Leave empty for all. ## `auctionFormats` (type: `array`): Filter by how the auction is run. Leave empty for all. ## `minBeds` (type: `integer`): Minimum number of bedrooms. ## `maxBeds` (type: `integer`): Maximum number of bedrooms. ## `minBaths` (type: `integer`): Minimum number of bathrooms. ## `minSqft` (type: `integer`): Minimum living area in square feet. ## `maxSqft` (type: `integer`): Maximum living area in square feet. ## `minPrice` (type: `integer`): Minimum starting bid in USD. ## `maxPrice` (type: `integer`): Maximum starting bid in USD. ## `sortBy` (type: `string`): Result ordering. ## `urls` (type: `array`): One or more Auction.com search URLs. Apply filters on the website, copy the URL, and paste it here. Multiple URLs supported; pagination walks forward from the page in each URL. Search-mode filter fields above are ignored. ## `fetchDetails` (type: `boolean`): Make an extra request per listing for the full photo gallery, complete auction terms, deposit/financing details and documents. Slower and billed per detail page; off by default. ## `maxPages` (type: `integer`): How many result pages to walk per search/URL (100 listings per page). ## `maxListings` (type: `integer`): Hard cap on total listings collected. 0 means unlimited (paid plans). ## `proxy` (type: `object`): Proxy configuration. Apify datacenter (the default) works well for this source; no residential proxy required. ## Actor input object example ```json { "mode": "search", "states": [ "CA" ], "listingStatus": "active", "sortBy": "default", "urls": [ "https://www.auction.com/residential/CA/active_lt" ], "fetchDetails": false, "maxPages": 5, "maxListings": 20, "proxy": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "states": [ "CA" ], "listingStatus": "active", "sortBy": "default", "urls": [ "https://www.auction.com/residential/CA/active_lt" ], "maxPages": 5, "maxListings": 20, "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/auction-com-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "states": ["CA"], "listingStatus": "active", "sortBy": "default", "urls": ["https://www.auction.com/residential/CA/active_lt"], "maxPages": 5, "maxListings": 20, "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/auction-com-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "states": [ "CA" ], "listingStatus": "active", "sortBy": "default", "urls": [ "https://www.auction.com/residential/CA/active_lt" ], "maxPages": 5, "maxListings": 20, "proxy": { "useApifyProxy": true } }' | apify call abotapi/auction-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/auction-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Auction.com $1💰 URL Search | Keyword Filtering | Rich Output", "description": "From $1/1K. Extract foreclosure, REO, short-sale, and auction listings from Auction.com in minutes. Search by location and property filters or paste any Auction.com URL. Get 45+ structured fields, including auction dates, bids, estimated values, occupancy status, coordinates, and photos.", "version": "1.0", "x-build-id": "EaKbEzZsLmwV0OqqF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~auction-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-auction-com-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/abotapi~auction-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-auction-com-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/abotapi~auction-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-auction-com-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to find listings. 'search' builds the query from the filter fields below. 'url' takes one or more Auction.com search URLs you paste.", "default": "search" }, "states": { "title": "States", "type": "array", "description": "Two-letter US state codes to search, e.g. CA, TX, FL. Leave empty to search nationwide.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "Optional city name to narrow the search, e.g. Los Angeles. Combine with a single state for best results." }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Optional list of 5-digit ZIP codes to narrow the search.", "items": { "type": "string" } }, "keyword": { "title": "Keyword / address", "type": "string", "description": "Optional free-text search across street, city, state and ZIP, e.g. 'Main St' or '90210'." }, "listingStatus": { "title": "Listing status", "enum": [ "active", "sold" ], "type": "string", "description": "Active listings open for bidding, or sold/closed listings.", "default": "active" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Filter by property category. Leave empty for all.", "items": { "type": "string", "enum": [ "single-family", "condos-townhouses", "multi-family", "land" ], "enumTitles": [ "Single Family", "Condos / Townhouses", "Multi Family", "Land" ] } }, "assetTypes": { "title": "Asset types", "type": "array", "description": "Filter by distressed-asset category. Leave empty for all.", "items": { "type": "string", "enum": [ "bank-owned", "foreclosures", "short-sales", "private-seller" ], "enumTitles": [ "Bank Owned / REO", "Foreclosures", "Short Sales", "Private Seller" ] } }, "auctionFormats": { "title": "Auction formats", "type": "array", "description": "Filter by how the auction is run. Leave empty for all.", "items": { "type": "string", "enum": [ "online", "in-person", "remote-bid" ], "enumTitles": [ "Online", "In Person", "Remote Bid" ] } }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms." }, "maxBeds": { "title": "Max bedrooms", "minimum": 0, "type": "integer", "description": "Maximum number of bedrooms." }, "minBaths": { "title": "Min bathrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bathrooms." }, "minSqft": { "title": "Min square footage", "minimum": 0, "type": "integer", "description": "Minimum living area in square feet." }, "maxSqft": { "title": "Max square footage", "minimum": 0, "type": "integer", "description": "Maximum living area in square feet." }, "minPrice": { "title": "Min starting bid", "minimum": 0, "type": "integer", "description": "Minimum starting bid in USD." }, "maxPrice": { "title": "Max starting bid", "minimum": 0, "type": "integer", "description": "Maximum starting bid in USD." }, "sortBy": { "title": "Sort by", "enum": [ "default", "auction-date-asc", "auction-date-desc", "price-asc", "price-desc", "newest" ], "type": "string", "description": "Result ordering.", "default": "default" }, "urls": { "title": "Auction.com URLs", "type": "array", "description": "One or more Auction.com search URLs. Apply filters on the website, copy the URL, and paste it here. Multiple URLs supported; pagination walks forward from the page in each URL. Search-mode filter fields above are ignored.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Make an extra request per listing for the full photo gallery, complete auction terms, deposit/financing details and documents. Slower and billed per detail page; off by default.", "default": false }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many result pages to walk per search/URL (100 listings per page).", "default": 5 }, "maxListings": { "title": "Max listings", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Hard cap on total listings collected. 0 means unlimited (paid plans).", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Proxy configuration. Apify datacenter (the default) works well for this source; no residential proxy required.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } } ```