# ShopGoodwill Scraper: Active and Sold Auctions (`getascraper/shopgoodwill-scraper`) Actor Scrape Goodwill online auctions and sold listings from ShopGoodwill.com using high-performance private APIs in under 10 seconds. Extract bids, buy-now prices, ending times, seller locations, and photos. - **URL**: https://apify.com/getascraper/shopgoodwill-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 item scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ### What does ShopGoodwill Scraper do? Get current Goodwill online auction and buy-it-now listings from ShopGoodwill.com: titles, current bid prices, bid counts, minimum bids, Buy It Now pricing, estimated shipping costs, seller regional store IDs, closes times, remaining times, and image URLs, ready for your spreadsheet in under 10 seconds. This scraper connects directly to the platform's high-performance REST APIs, bypasses WAF blocks using free proxies, and returns clean, fully-structured JSON. Built for thrift flippers, vintage resellers, e-commerce arbitrage analysts, and bargain hunters. ### Why use ShopGoodwill Scraper? - **I am a thrift flipper** watching high-demand vintage clothing, retro video games, and cameras across different regional Goodwill stores to buy underpriced lots. - **I am a designer reseller** tracking closing times and bid activity on luxury bags, sterling silver, and collectible jewelry to place winning last-second bids. - **I am a market-research analyst** building weekly reports on secondary market demand, average order values, and category trends in online thrift marketplaces. - **I am a bargain hunter** looking for used electronics or tools under my target budget. - **I am an e-commerce store owner** sourcing unique collectible home decor inventory from regional liquidations. ### How to use ShopGoodwill Scraper 1. Create a free Apify account (no credit card needed). 2. Open the ShopGoodwill Scraper in the Apify Console. 3. Type one or more keywords (e.g. `vintage`, `camera`) or paste direct category links. 4. Set optional filters for category ID, price ranges in USD, buy-now format, or local pickup. 5. Click **Start** and download your structured lot catalog as CSV, Excel, or JSON. ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `searchQueries` | array of strings | No | Keywords to search (e.g. `vintage`, `camera`). Leave blank if using direct Start URLs. | | `startUrls` | array of URLs | No | Direct category or brand links (e.g. `https://www.shopgoodwill.com/categories/antiques`). Overrides keywords. | | `categoryId` | integer | No | Restrict queries to a specific category ID (0 = all categories). Use 27 for clothing, 2 for cameras, etc. | | `lowPrice` | integer | No | Only include auctions priced at or above this USD value. 0 = no minimum. | | `highPrice` | integer | No | Only include auctions priced at or below this USD value. 999999 = no maximum. | | `searchBuyNowOnly` | boolean | No | When enabled, only extracts listings featuring a flat Buy It Now purchase option. | | `searchPickupOnly` | boolean | No | When enabled, restricts output strictly to listings that require local physical store pick-up. | | `maxItems` | integer | No | Maximum number of auction lots to extract per search. Defaults to 100. | | `debugLogging` | boolean | No | Print detailed tags (API, FETCH, EMIT) to the run log. Defaults to false. | | `proxyConfiguration` | object | Yes | Proxy options. Required. Shared proxy BUYPROXIES94952 or residential proxy is mandatory to bypass Azure Front Door. | ### Output A structured dataset of auction items with prices, bid counts, closing times, shipping fees, and photo links. Free users get up to 50 results per run, paid plans scale to 1,000,000. ```json { "itemId": "267236060", "title": "Vintage Lite-Brite", "currentPrice": 13.99, "minimumBid": 13.99, "buyNowPrice": 0, "numBids": 0, "shippingPrice": 9.25, "sellerId": 32, "endTime": "2026-06-18T19:08:00", "remainingTime": "3d 17h", "categoryId": 27, "categoryName": "Toys", "imageURL": "https://shopgoodwillimages.azureedge.net/production/32/Items/06-14-2026/b2849ef9-56b3-4f77-a9f8-996d5bbec654_0614t1.jpeg", "listingUrl": "https://shopgoodwill.com/item/267236060", "scrapedAt": "2026-06-15T02:06:45.329Z" } ```` ### Data table | Field | Type | Description | | --- | --- | --- | | `itemId` | string | Unique ShopGoodwill item listing identifier. | | `title` | string | Full auction display title. | | `currentPrice` | number | Current high bid amount in US dollars. | | `minimumBid` | number | Minimum acceptable bid amount in US dollars. | | `buyNowPrice` | number | Direct Buy It Now price in USD (0 if not available). | | `numBids` | number | Total number of bids placed. | | `shippingPrice` | number | Estimated shipping cost in USD. | | `sellerId` | number | Unique identifier of the hosting Goodwill regional store. | | `endTime` | string | UTC ISO timestamp when the auction closes. | | `remainingTime` | string | Time left to place a bid (e.g. `1h 47m`). | | `categoryId` | number | Internal category ID. | | `categoryName` | string | Display name of the category class. | | `imageURL` | string | Primary auction lot photo link. | | `listingUrl` | string | Canonical link to the bidding page. | | `scrapedAt` | string | ISO 8601 timestamp of when the row was scraped. | ### Pricing The Actor costs **$2.99 per 1,000 results**. A typical run extracting 500 items costs about $1.50. Because the scraper connects directly to ShopGoodwill private REST endpoints instead of launching heavy browsers, proxy bandwidth consumption is extremely low, keeping your total costs at the absolute minimum. ### Tips or advanced options - **No browser overhead.** Because this scraper connects directly to ShopGoodwill private backend catalog APIs, it does not launch Chrome or execute heavy scripts. This makes it 100x faster than browser-based scrapers. - **Undercuts all competitors.** The other three scrapers on the store charge $6.00 to $8.00 per 1k results and use slow headless browsers. This Actor is cheaper, faster, and unblocked. - **Filter before downloading.** Use the `categoryId`, `lowPrice`, `highPrice`, `searchBuyNowOnly`, and `searchPickupOnly` parameters to filter results during extraction to keep rows relevant. ### FAQ, disclaimers, and support ##### Is the ShopGoodwill scraper legal? Yes. The ShopGoodwill scraper accesses public catalog and search data that is publicly visible to any logged-out human in a browser. It does not require customer login, place automated orders, or bypass paywalls. You are responsible for compliance with local laws. ##### Does this scraper require proxies? Yes. ShopGoodwill uses Azure Front Door which blocks raw cloud container IPs. Shared datacenter proxy BUYPROXIES94952 (available in your plan) completely bypasses this and has zero bandwidth limits. ##### Which categories are supported? All public ShopGoodwill categories (Antiques, Clothing, Collectibles, Electronics, Jewelry, Toys, etc.) are supported. You can search by keyword or paste any catalog search link directly. **Disclaimer:** This Actor accesses public web listing data only. It does not bypass authentication, paywalls, or anti-bot systems on the live site. ShopGoodwill is the registered trademark of Goodwill Industries International, Inc. This Actor is affiliation-free, and not endorsed or sponsored by Goodwill Industries. # Actor input Schema ## `searchQueries` (type: `array`): Product keywords (e.g. 'vintage', 'camera'). Leave empty if using direct Start URLs. ## `startUrls` (type: `array`): Direct category or brand search links (e.g. 'https://www.shopgoodwill.com/categories/antiques'). Overrides queries. ## `categoryId` (type: `integer`): Restrict queries to a specific category ID (0 = all categories). Use 27 for clothing, 2 for cameras, etc. ## `lowPrice` (type: `integer`): Only include auctions with a current bid at or above this value. 0 = no minimum. ## `highPrice` (type: `integer`): Only include auctions with a current bid at or below this value. 0 = no maximum. ## `searchBuyNowOnly` (type: `boolean`): When enabled, only extracts listings featuring a flat Buy It Now purchase option. ## `searchPickupOnly` (type: `boolean`): When enabled, restricts output strictly to listings that require local physical store pick-up. ## `maxItems` (type: `integer`): Maximum number of auction lots to extract per search. Defaults to 100. ## `debugLogging` (type: `boolean`): Print granular tracing tags (API, FETCH, EMIT) to the run logs. ## `proxyConfiguration` (type: `object`): Proxy options. Required. Datacenter shared proxy BUYPROXIES94952 or residential proxy is mandatory to bypass Azure Front Door. ## Actor input object example ```json { "searchQueries": [ "vintage" ], "startUrls": [], "categoryId": 0, "lowPrice": 0, "highPrice": 999999, "searchBuyNowOnly": false, "searchPickupOnly": false, "maxItems": 100, "debugLogging": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "BUYPROXIES94952" ] } } ``` # Actor output Schema ## `results` (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 = { "searchQueries": [ "vintage" ], "startUrls": [], "categoryId": 0, "lowPrice": 0, "highPrice": 999999, "searchBuyNowOnly": false, "searchPickupOnly": false, "maxItems": 100, "debugLogging": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "BUYPROXIES94952" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/shopgoodwill-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 = { "searchQueries": ["vintage"], "startUrls": [], "categoryId": 0, "lowPrice": 0, "highPrice": 999999, "searchBuyNowOnly": False, "searchPickupOnly": False, "maxItems": 100, "debugLogging": False, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["BUYPROXIES94952"], }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/shopgoodwill-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 '{ "searchQueries": [ "vintage" ], "startUrls": [], "categoryId": 0, "lowPrice": 0, "highPrice": 999999, "searchBuyNowOnly": false, "searchPickupOnly": false, "maxItems": 100, "debugLogging": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "BUYPROXIES94952" ] } }' | apify call getascraper/shopgoodwill-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/shopgoodwill-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ShopGoodwill Scraper: Active and Sold Auctions", "description": "Scrape Goodwill online auctions and sold listings from ShopGoodwill.com using high-performance private APIs in under 10 seconds. Extract bids, buy-now prices, ending times, seller locations, and photos.", "version": "0.1", "x-build-id": "Z7hJqSA2IJY25Br7a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~shopgoodwill-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-shopgoodwill-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/getascraper~shopgoodwill-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-shopgoodwill-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/getascraper~shopgoodwill-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-shopgoodwill-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Product keywords (e.g. 'vintage', 'camera'). Leave empty if using direct Start URLs.", "default": [ "vintage" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct category or brand search links (e.g. 'https://www.shopgoodwill.com/categories/antiques'). Overrides queries.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categoryId": { "title": "Category filter", "minimum": 0, "type": "integer", "description": "Restrict queries to a specific category ID (0 = all categories). Use 27 for clothing, 2 for cameras, etc.", "default": 0 }, "lowPrice": { "title": "Min bid price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include auctions with a current bid at or above this value. 0 = no minimum.", "default": 0 }, "highPrice": { "title": "Max bid price (USD)", "minimum": 0, "maximum": 999999, "type": "integer", "description": "Only include auctions with a current bid at or below this value. 0 = no maximum.", "default": 999999 }, "searchBuyNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "When enabled, only extracts listings featuring a flat Buy It Now purchase option.", "default": false }, "searchPickupOnly": { "title": "Local pickup only", "type": "boolean", "description": "When enabled, restricts output strictly to listings that require local physical store pick-up.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum number of auction lots to extract per search. Defaults to 100.", "default": 100 }, "debugLogging": { "title": "Verbose debug logs", "type": "boolean", "description": "Print granular tracing tags (API, FETCH, EMIT) to the run logs.", "default": false }, "proxyConfiguration": { "title": "Proxy setup", "type": "object", "description": "Proxy options. Required. Datacenter shared proxy BUYPROXIES94952 or residential proxy is mandatory to bypass Azure Front Door.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "BUYPROXIES94952" ] } } } }, "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 } } } } } } } } } } ```