# ShopGoodwill Auction Scraper โ€” Keyword Search, Bids & Monitor (`scrapersdelight/shopgoodwill-scraper`) Actor Scrape ShopGoodwill.com auctions by keyword, category, or seller โ€” title, price, bids, end time, Buy Now, images, item URL. Optional detail enrichment (seller, pickup, bid history) plus a saved-search monitor with Slack/email/webhook alerts. No login or API key. From $4 per 1,000 items. - **URL**: https://apify.com/scrapersdelight/shopgoodwill-scraper.md - **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ## ๐Ÿ›๏ธ ShopGoodwill Auction Scraper & Saved-Search Monitor **Scrape live ShopGoodwill.com auctions โ€” title, current price, bid count, end time, Buy Now price, seller, shipping, photos, and item URL โ€” by keyword, category, seller, or price range. Then run it on a schedule as a saved-search monitor that pings Slack, email, or webhook the moment a fresh listing drops, so you bid first.** Turn ShopGoodwill into a clean dataset or a real-time deal alert. No login, no API key, no browser automation โ€” the actor reads the site's own public JSON API and filters server-side, so you pull only the items you actually want. --- ### What does ShopGoodwill Scraper do? ShopGoodwill Scraper extracts **thrift & charity auction listings** from [ShopGoodwill.com](https://shopgoodwill.com) โ€” the largest nonprofit auction site in the US, where 100+ regional Goodwill organizations auction donated jewelry, electronics, collectibles, art, instruments, fashion, and more โ€” and returns clean, structured rows you can export to **JSON, CSV, Excel, or push to your app via API**. - ๐Ÿ”Ž **Search the way the site does** โ€” keyword, category, multi-category, seller (regional Goodwill), price band, Buy-Now-only, pickup-only. All server-side. - ๐Ÿ’ฐ **Live auction economics** โ€” current price, bid count, minimum next bid, starting price, Buy Now / discounted Buy Now, shipping price. - โฐ **Time-aware** โ€” exact start/end times plus the site's own time-left countdown. - ๐Ÿท๏ธ **Category & seller** โ€” category name + full path and the listing Goodwill's seller id (name with details on). - ๐Ÿ“ฆ **Full detail enrichment** *(optional)* โ€” description, seller organization name, pickup city/state/zip, bid increment, bid history, reserve status, handling price, and the full-size photo gallery. - ๐Ÿ•ต๏ธ **Sold-price research** โ€” flip one switch to search **closed auctions** up to 90 days back. - ๐Ÿ”” **Saved-search monitor** โ€” schedule it and get **Slack / email / webhook alerts** for newly listed items matching your query. --- ### What data does it extract? For every auction listing: - ๐Ÿ†” `item_id`, ๐Ÿ”— `item_url`, ๐Ÿท๏ธ `title` - ๐Ÿ’ต `current_price`, `minimum_bid`, `starting_price`, `buy_now_price`, `discounted_buy_now_price` - ๐Ÿ”จ `num_bids`, `has_bid`, `bid_increment`*, `bid_history`*, `reserve_met`* - ๐Ÿšš `shipping_price`, `handling_price`*, `pickup_city`* / `pickup_state`* / `pickup_zip`* - ๐Ÿข `seller_id`, `seller_name`*, `shipping_policy`*, `pickup_policy`* - ๐Ÿ—‚๏ธ `category_id`, `category_name`, `category_path` - ๐Ÿ“ `description`*, ๐Ÿ“ฆ `quantity`, `max_quantity`*, ๐Ÿ‘€ `views` - ๐Ÿ–ผ๏ธ `image_url`, `gallery_url`, `images[]`* - ๐Ÿ“… `start_time`, `end_time`, โณ `remaining_time` - โœจ `is_new` (monitor mode), ๐Ÿ•’ `scraped_at` *\* = filled by the optional `fetchDetails` enrichment.* --- ### Who is it for? - ๐Ÿ›’ **Resellers & flippers** sourcing underpriced jewelry, electronics, cameras, and collectibles. - ๐Ÿ’Ž **Niche collectors** (watches, vinyl, trading cards, instruments) watching for grails the moment they list. - ๐Ÿ“ˆ **Price researchers** pulling closed-auction sold prices for comps and arbitrage math. - ๐Ÿค– **Deal-alert builders** wiring fresh listings into Slack, Discord (via webhook), or their own apps. - ๐Ÿ“Š **Marketplace analysts** tracking volumes, categories, and price levels across regional Goodwills. --- ### Two ways to use it 1. **Bulk scrape** โ€” pull every active (or recently closed) listing for a keyword, category, seller, or price band into one clean dataset. 2. **Saved-search monitor** *(the recurring play)* โ€” set `monitorMode: true`, attach an **Apify Schedule** (e.g. every 30 min for hot keywords), and the actor emits/alerts **only items new since the last run**. Pair with `sortBy: "newest"` so fresh listings land in the scrape window first. --- ### How to use it (step by step) 1. Click **Try for free**. 2. Enter a **Search keyword** (e.g. `laptop`) โ€” or leave it empty and pick a **Category ID** / **Seller IDs** to sweep a whole section. 3. *(Optional)* add filters: price range, Buy It Now only, pickup only, closed auctions. 4. *(Optional)* turn on **Fetch full details** for description, seller name, pickup location, bid history, and the full gallery. 5. Click **Start**, then open the **Dataset** tab to view/export. 6. *(Optional)* set **monitorMode** + a **Schedule** + an alert channel to get pinged on new listings. #### Quick start ```json { "searchText": "laptop", "maxItems": 50 } ```` #### Saved-search monitor example ```json { "searchText": "omega seamaster", "sortBy": "newest", "monitorMode": true, "alertOnNewItem": true, "slackWebhookUrl": "https://hooks.slack.com/services/โ€ฆ" } ``` #### Sold-price research example ```json { "searchText": "nintendo switch", "includeClosedAuctions": true, "closedAuctionDaysBack": 30, "maxItems": 200 } ``` *** ### Input | Field | What it does | |-------|--------------| | `searchText` | keyword to search (empty = all listings; combine with a category/seller) | | `categoryId` / `selectedCategoryIds` | one category id, or a comma list of several | | `selectedSellerIds` | restrict to specific regional Goodwill sellers (comma list of ids) | | `priceMin` / `priceMax` | only items in this current-price band | | `buyNowOnly` / `pickupOnly` | Buy-It-Now-able / local-pickup-only listings | | `searchDescriptions` | also match the keyword in descriptions | | `includeClosedAuctions` + `closedAuctionDaysBack` | search ended auctions (sold-price comps) | | `sortBy` | `ending` ยท `newest` ยท `oldest` ยท `price-low` ยท `price-high` | | `fetchDetails` | add description, seller name, pickup location, bid history, full gallery | | `maxItems` | hard cap per run (0 = unlimited) | | `monitorMode`, `alertOnNewItem`, `alertOnBidChange`, `watchlistItemIds` | recurring watcher + alerts | | `webhookUrl`, `slackWebhookUrl`, `emailRecipients` | alert channels | | `proxyConfiguration`, `requestConcurrency` | proxy + parallelism (datacenter is enough) | *** ### Output Each listing is one dataset record (fields listed above). Export to **JSON, CSV, Excel, HTML, or RSS**, or fetch via the **Apify API**. Prices are numbers in USD; `start_time` / `end_time` are the site's timestamps; `remaining_time` is the site's own countdown string. Example record (truncated): ```json { "item_id": "266505251", "item_url": "https://shopgoodwill.com/item/266505251", "title": "Lenovo IdeaPad 3 15\" Linux Mint Laptop 128GB", "current_price": 43.0, "num_bids": 6, "minimum_bid": 44.0, "starting_price": 14.99, "shipping_price": 0, "end_time": "2026-06-12T16:00:00", "remaining_time": "1h 22m", "seller_id": "43", "seller_name": "Goodwill Industries of Central Texas", "pickup_city": "Austin", "pickup_state": "TX", "category_name": "Laptops & Notebooks", "category_path": "Computers & Electronics > Laptops & Notebooks", "image_url": "https://shopgoodwillimages.azureedge.net/production/43/Items/โ€ฆt1.jpeg", "images": ["https://shopgoodwillimages.azureedge.net/production/43/Items/โ€ฆ1.jpg"] } ``` *** ### How much does it cost? Pay-per-event โ€” you pay for what you pull, no subscription. Suggested rates: | Event | What it covers | Suggested price | |-------|----------------|-----------------| | `lot-scraped` | each listing returned | ~$0.004 / item | | `lot-detail-enriched` | each detail-API fetch | ~$0.004 / item | | `monitor-run-completed` | each scheduled watch run | ~$0.05 / run | | `new-lot-detected` | each newly listed item | ~$0.02 / item | | `alert-delivered` | each Slack/email/webhook push | ~$0.005 / alert | *(Final per-event prices are set on the actor's pricing page.)* That's about **$4 per 1,000 listings** โ€” and a keyword monitor that runs hourly costs a few cents a day plus the new items it actually finds. *** ### Is it legal to scrape ShopGoodwill? ShopGoodwill listings are **public auction data**, browsable without a login, and the records are item/listing data โ€” not personal data (bid history shows only anonymized nicknames the site itself displays). Scraping publicly available listings is generally legal, but you are responsible for your use: **review the current ShopGoodwill Terms of Service before commercial use or resale of the data**. *** ### FAQ **What is ShopGoodwill?** ShopGoodwill.com is the official online auction marketplace of Goodwill โ€” 100+ regional Goodwill nonprofits list donated jewelry, electronics, collectibles, art, fashion, and more, with new auctions ending every minute. **Do I need an account, login, or API key?** No. The actor reads the site's public listing data directly โ€” no account, cookies, or API key required. **Can I monitor a saved search and get alerts?** Yes. Turn on `monitorMode`, attach an Apify **Schedule**, and add a Slack/webhook/email channel. Each run emits and alerts **only items new since the last run** for that exact search scope. **Can I get sold prices / closed auctions?** Yes โ€” set `includeClosedAuctions: true` and `closedAuctionDaysBack` (up to 90). Great for comps before you bid. **Can I filter by category or a specific Goodwill store?** Yes โ€” `categoryId` (or `selectedCategoryIds` for several) and `selectedSellerIds` for specific regional Goodwills. Combine with keyword and price filters. **How do I find category and seller IDs?** Browse shopgoodwill.com โ€” the numeric ids appear in the category and seller page URLs. E.g. category 7 = Computers & Electronics. **Does it return photos?** Yes โ€” every listing has `image_url`; turn on `fetchDetails` for the full-size `images[]` gallery. **Does it return the bid history?** Yes, with `fetchDetails` on โ€” amounts, quantities, timestamps, and the site's anonymized bidder nicknames. **How fast is it?** The site serves 40 listings per request from a JSON API in well under a second โ€” 1,000 items typically take under a minute without details. **Can I scrape everything, not just one keyword?** Yes โ€” leave `searchText` empty and set `maxItems: 0` for an unlimited sweep (optionally scoped to a category or seller). **How do I export the data?** JSON, CSV, Excel, HTML, or RSS from the Dataset tab, or via the Apify API. **Can I integrate with Make, Zapier, n8n, or my backend?** Yes โ€” use the webhook/Slack channels for alerts, or the Apify API to pipe the dataset anywhere. *** ### You might also like - ๐Ÿ›๏ธ Government & surplus auction scrapers (GovDeals, GSA Auctions, PublicSurplus) - ๐Ÿ”จ General online auction & marketplace scrapers - ๐Ÿ“ฆ Storage-unit and estate-sale auction scrapers *** ### Feedback Found a missing field or want a new filter? Open an issue on the actor โ€” fast fixes and feature requests welcome. # Actor input Schema ## `searchText` (type: `string`): Keyword matched against item titles (and descriptions when 'Search descriptions' is on). Leave empty to scrape ALL active listings (combine with a category or seller filter). ## `categoryId` (type: `integer`): ShopGoodwill numeric category id, e.g. 7 = Computers & Electronics. 0 = all categories. Find ids in the category page URL on shopgoodwill.com. ## `selectedCategoryIds` (type: `string`): Comma-separated list of category ids to search across at once (overrides the single Category ID above when set). ## `selectedSellerIds` (type: `string`): Comma-separated seller (regional Goodwill) ids to restrict the search to, e.g. '43'. Each seller's id appears in its shopgoodwill.com seller page URL. ## `priceMin` (type: `integer`): Only return items with a current price at/above this. Leave empty for no floor. ## `priceMax` (type: `integer`): Only return items with a current price at/below this โ€” bargain filter. Leave empty for no cap. ## `buyNowOnly` (type: `boolean`): Only listings that can be bought instantly at the Buy Now price. ## `pickupOnly` (type: `boolean`): Only listings offered for local pickup (no shipping). ## `searchDescriptions` (type: `boolean`): Also match the keyword inside item descriptions (broader, noisier results). ## `includeClosedAuctions` (type: `boolean`): Search recently ended auctions instead of active ones โ€” great for sold-price research. Pair with 'Closed days back'. ## `closedAuctionDaysBack` (type: `integer`): When searching closed auctions, how many days back to include (site default 7). ## `sortBy` (type: `string`): Result ordering (server-side). 'Newest first' surfaces freshly listed items โ€” best for monitors. ## `fetchDetails` (type: `boolean`): Call the item-detail API for each item: full description, seller name, pickup city/state/zip, bid increment, bid history, reserve status, handling price, full-size photo gallery. One extra request per item. ## `maxItems` (type: `integer`): Hard cap on items scraped this run (cost/safety guard). Defaults to 50 for a fast first run โ€” set to 0 for an unlimited bulk scrape of the whole result set. ## `monitorMode` (type: `boolean`): Recurring watcher: diff against the prior run's seen items (per search scope) and output/alert ONLY newly-listed items. Pair with an Apify Schedule and Sort by = Newest first. ## `alertOnNewItem` (type: `boolean`): In monitor mode, deliver an alert for each newly-listed item via the channels below. ## `alertOnBidChange` (type: `boolean`): Also alert when the current price changes on a watched item (see watchlist IDs). ## `watchlistItemIds` (type: `array`): Specific item ids to track for price changes when 'Alert on bid/price changes' is on. ## `webhookUrl` (type: `string`): POST endpoint for new-item alert payloads (Make / Zapier / n8n / custom). One JSON body per alert. ## `slackWebhookUrl` (type: `string`): Slack incoming-webhook URL for formatted new-item cards. ## `emailRecipients` (type: `array`): Email addresses for the new-item digest (sent via apify/send-mail). ## `proxyConfiguration` (type: `object`): Proxy settings. Datacenter rotation is enough for this site (public JSON API, no anti-bot). ## `requestConcurrency` (type: `integer`): Max parallel requests for detail fetches. Keep modest to respect the site's rate limits. ## `diagnose` (type: `boolean`): Dev only. Dumps the raw search + detail API JSON to the key-value store (DEBUG\_SEARCH\_JSON / DEBUG\_DETAIL\_JSON) and logs the parsed first row + pagination check, then exits. Leave off for normal runs. ## Actor input object example ```json { "searchText": "laptop", "categoryId": 0, "buyNowOnly": false, "pickupOnly": false, "searchDescriptions": false, "includeClosedAuctions": false, "closedAuctionDaysBack": 7, "sortBy": "ending", "fetchDetails": false, "maxItems": 50, "monitorMode": false, "alertOnNewItem": true, "alertOnBidChange": false, "proxyConfiguration": { "useApifyProxy": true }, "requestConcurrency": 5, "diagnose": false } ``` # Actor output Schema ## `items` (type: `string`): The dataset of scraped ShopGoodwill listings (one item per row). # 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 = { "searchText": "laptop", "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("scrapersdelight/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 = { "searchText": "laptop", "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("scrapersdelight/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 '{ "searchText": "laptop", "maxItems": 50 }' | apify call scrapersdelight/shopgoodwill-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapersdelight/shopgoodwill-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ShopGoodwill Auction Scraper โ€” Keyword Search, Bids & Monitor", "description": "Scrape ShopGoodwill.com auctions by keyword, category, or seller โ€” title, price, bids, end time, Buy Now, images, item URL. Optional detail enrichment (seller, pickup, bid history) plus a saved-search monitor with Slack/email/webhook alerts. No login or API key. From $4 per 1,000 items.", "version": "0.1", "x-build-id": "fAMJywozE6TckTwL0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~shopgoodwill-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-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/scrapersdelight~shopgoodwill-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-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/scrapersdelight~shopgoodwill-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-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": { "searchText": { "title": "Search keyword", "type": "string", "description": "Keyword matched against item titles (and descriptions when 'Search descriptions' is on). Leave empty to scrape ALL active listings (combine with a category or seller filter)." }, "categoryId": { "title": "Category ID", "type": "integer", "description": "ShopGoodwill numeric category id, e.g. 7 = Computers & Electronics. 0 = all categories. Find ids in the category page URL on shopgoodwill.com.", "default": 0 }, "selectedCategoryIds": { "title": "Multiple category IDs", "type": "string", "description": "Comma-separated list of category ids to search across at once (overrides the single Category ID above when set)." }, "selectedSellerIds": { "title": "Seller IDs", "type": "string", "description": "Comma-separated seller (regional Goodwill) ids to restrict the search to, e.g. '43'. Each seller's id appears in its shopgoodwill.com seller page URL." }, "priceMin": { "title": "Min price ($)", "minimum": 0, "type": "integer", "description": "Only return items with a current price at/above this. Leave empty for no floor." }, "priceMax": { "title": "Max price ($)", "minimum": 0, "type": "integer", "description": "Only return items with a current price at/below this โ€” bargain filter. Leave empty for no cap." }, "buyNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "Only listings that can be bought instantly at the Buy Now price.", "default": false }, "pickupOnly": { "title": "Pickup-only listings", "type": "boolean", "description": "Only listings offered for local pickup (no shipping).", "default": false }, "searchDescriptions": { "title": "Search descriptions too", "type": "boolean", "description": "Also match the keyword inside item descriptions (broader, noisier results).", "default": false }, "includeClosedAuctions": { "title": "Search CLOSED auctions", "type": "boolean", "description": "Search recently ended auctions instead of active ones โ€” great for sold-price research. Pair with 'Closed days back'.", "default": false }, "closedAuctionDaysBack": { "title": "Closed days back", "minimum": 1, "maximum": 90, "type": "integer", "description": "When searching closed auctions, how many days back to include (site default 7).", "default": 7 }, "sortBy": { "title": "Sort by", "enum": [ "ending", "newest", "oldest", "price-low", "price-high" ], "type": "string", "description": "Result ordering (server-side). 'Newest first' surfaces freshly listed items โ€” best for monitors.", "default": "ending" }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Call the item-detail API for each item: full description, seller name, pickup city/state/zip, bid increment, bid history, reserve status, handling price, full-size photo gallery. One extra request per item.", "default": false }, "maxItems": { "title": "Max items per run", "minimum": 0, "type": "integer", "description": "Hard cap on items scraped this run (cost/safety guard). Defaults to 50 for a fast first run โ€” set to 0 for an unlimited bulk scrape of the whole result set.", "default": 50 }, "monitorMode": { "title": "Monitor mode (saved-search watcher)", "type": "boolean", "description": "Recurring watcher: diff against the prior run's seen items (per search scope) and output/alert ONLY newly-listed items. Pair with an Apify Schedule and Sort by = Newest first.", "default": false }, "alertOnNewItem": { "title": "Alert on new items", "type": "boolean", "description": "In monitor mode, deliver an alert for each newly-listed item via the channels below.", "default": true }, "alertOnBidChange": { "title": "Alert on bid/price changes (watchlist)", "type": "boolean", "description": "Also alert when the current price changes on a watched item (see watchlist IDs).", "default": false }, "watchlistItemIds": { "title": "Watchlist item IDs", "type": "array", "description": "Specific item ids to track for price changes when 'Alert on bid/price changes' is on.", "items": { "type": "string" } }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST endpoint for new-item alert payloads (Make / Zapier / n8n / custom). One JSON body per alert." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL for formatted new-item cards." }, "emailRecipients": { "title": "Email recipients", "type": "array", "description": "Email addresses for the new-item digest (sent via apify/send-mail).", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. Datacenter rotation is enough for this site (public JSON API, no anti-bot).", "default": { "useApifyProxy": true } }, "requestConcurrency": { "title": "Request concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Max parallel requests for detail fetches. Keep modest to respect the site's rate limits.", "default": 5 }, "diagnose": { "title": "Diagnostic mode (dev)", "type": "boolean", "description": "Dev only. Dumps the raw search + detail API JSON to the key-value store (DEBUG_SEARCH_JSON / DEBUG_DETAIL_JSON) and logs the parsed first row + pagination check, then exits. Leave off for normal runs.", "default": false } } }, "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 } } } } } } } } } } ```