{ "openapi": "3.0.1", "info": { "title": "ShopGoodwill Real Time Scraper — Live Thrift & Resale Data", "description": "Live ShopGoodwill thrift & vintage intelligence: keyword search, full listing details, closet inventory, seller profiles, sold comps, and URL collection. Stream structured JSON to your dataset in real time, push Slack/Discord deal alerts, and feed pricing bots or AI agents.", "version": "0.0", "x-build-id": "rkqD1ZDudb1Wd1waB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~ShopGoodwill-Real-Time-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-ShopGoodwill-Real-Time-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/b2b_leads~ShopGoodwill-Real-Time-Scraper/runs": { "post": { "operationId": "runs-sync-b2b_leads-ShopGoodwill-Real-Time-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/b2b_leads~ShopGoodwill-Real-Time-Scraper/run-sync": { "post": { "operationId": "run-sync-b2b_leads-ShopGoodwill-Real-Time-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": { "enableListingSearch": { "title": "Listing Search", "type": "boolean", "description": "Live keyword search for thrift brands, streetwear, and vintage finds. On by default — prefilled so you can click Start immediately.", "default": true }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "One or more search terms (e.g. carhartt detroit jacket, levis 501 jeans, patagonia fleece). Keep phrases short — 2–3 words match best. Required when Listing Search is on.", "default": [ "carhartt detroit jacket", "levis 501 jeans", "patagonia fleece" ], "items": { "type": "string" } }, "searchMaxResults": { "title": "Max results per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum listings to return for each keyword (1–200). Defaults to 10 for fast instant demo runs.", "default": 10 }, "searchSort": { "title": "Sort order", "enum": [ "relevance", "newest", "ending-soonest", "price-low", "price-high", "most-bids" ], "type": "string", "description": "How to order search results.", "default": "newest" }, "searchBrand": { "title": "Brand filter (optional)", "type": "string", "description": "Limit results to a brand name (e.g. Carhartt, Levi's, Patagonia, Nike).", "default": "" }, "searchSize": { "title": "Size filter (optional)", "type": "string", "description": "e.g. M, L, XL, 32x32, 9.5.", "default": "" }, "searchCondition": { "title": "Condition filter (optional)", "type": "string", "description": "Only keep listings whose stated condition matches one of these words (e.g. New, Like New, Excellent, Good, Fair, Used).", "default": "" }, "searchMinPrice": { "title": "Min price (optional)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Minimum current price in USD." }, "searchMaxPrice": { "title": "Max price (optional)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum current price in USD." }, "searchBuyNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "Only return fixed-price Buy-It-Now listings (skip pure auctions).", "default": false }, "searchFetchFullDetails": { "title": "Enrich with full listing details", "type": "boolean", "description": "When on, each search result is one row with full fields merged in (description, fabric/material tags, style tags, full image gallery, shipping discounts). Still featureType listing_search — not a second row. Adds a little extra time per listing to enrich full product details.", "default": false }, "enableListingDetails": { "title": "Listing Details", "type": "boolean", "description": "Fetch full product data for specific listing IDs or ShopGoodwill URLs.", "default": false }, "listingIds": { "title": "Listing IDs", "type": "array", "description": "Numeric ShopGoodwill listing IDs (e.g. 90001) or full item URLs (https://shopgoodwill.com/item/90001).", "default": [], "items": { "type": "string" } }, "enableClosetListings": { "title": "Closet Listings", "type": "boolean", "description": "Scrape a Goodwill region's full live inventory to track competitor stock and source in bulk.", "default": false }, "sellerIds": { "title": "Seller / region IDs", "type": "array", "description": "ShopGoodwill seller (Goodwill region) IDs. Used by Closet Listings, Seller Profile, and Sold Comps. Find the ID in any shopgoodwill.com seller page URL.", "default": [], "items": { "type": "string" } }, "closetMaxListings": { "title": "Max listings per closet", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum live inventory items to collect per seller (1–1000).", "default": 50 }, "closetCategories": { "title": "Closet category IDs (optional)", "type": "array", "description": "Optional ShopGoodwill category IDs to narrow the closet inventory (e.g. clothing categories). Leave empty for everything.", "default": [], "items": { "type": "string" } }, "enableSellerProfile": { "title": "Seller Profile", "type": "boolean", "description": "Extract Goodwill region stats: items listed, live inventory size, seller rating, location, and bio details.", "default": false }, "enableSoldComps": { "title": "Sold Item Comps / History", "type": "boolean", "description": "Collect completed auctions for real market comps, resale margins, and sell-through analysis.", "default": false }, "soldKeywords": { "title": "Sold comp keywords", "type": "array", "description": "Optional keywords to narrow completed auctions (e.g. carhartt jacket, levis 501). Leave empty for all completed auctions in your price/category range.", "default": [], "items": { "type": "string" } }, "soldDaysBack": { "title": "Days back", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many days of completed-auction history to scan (1–30).", "default": 7 }, "soldMaxItems": { "title": "Max sold comps", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum completed listings to collect (1–1000).", "default": 50 }, "enableScrapeByUrl": { "title": "Scrape By URL", "type": "boolean", "description": "Paste any ShopGoodwill URL — item, search, seller, or category.", "default": false }, "scrapeUrls": { "title": "ShopGoodwill URLs", "type": "array", "description": "Any ShopGoodwill item, search, seller, or category URL.", "default": [], "items": { "type": "string" } }, "scrapeMaxPages": { "title": "Max pages per URL", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many result batches to collect per search and closet URL (1–20).", "default": 3 }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Every record is always saved to the run dataset — this webhook is an ADDITIONAL real-time push. Each new row is also POSTed to this URL (Slack, Discord, Zapier, Make, n8n, custom pricing bot).", "default": "" }, "webhookFormat": { "title": "Webhook format", "enum": [ "json", "slack" ], "type": "string", "description": "json = full record object; slack = Slack-friendly message payload.", "default": "json" }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "Residential proxy recommended. Match country to your target market (US default).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }