{ "openapi": "3.0.1", "info": { "title": "GovDeals Auction Results Scraper", "description": "Scrapes closed GovDeals auction listings by search term, category, or direct URL. Returns final price, bid count, seller, location, and auction dates for each asset.", "version": "0.0", "x-build-id": "AaJvdovp7hlqPtd0l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~govdeals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-govdeals-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/parseforge~govdeals-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-govdeals-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/parseforge~govdeals-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-govdeals-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 term for listings", "type": "string", "description": "Keyword search query (e.g. 'ford truck', 'laptop', 'police car'). If provided, startUrl is ignored." }, "startUrl": { "title": "GovDeals listing URL", "type": "string", "description": "GovDeals.com asset URL to scrape a specific closed auction. If provided, search filters are ignored." }, "maxItems": { "title": "Maximum listings", "type": "integer", "description": "How many listings to collect per run." }, "categoryIds": { "title": "Category IDs", "type": "string", "description": "Category code to filter results (e.g. '94A' for Cars, '94B' for Trucks, '94L' for SUVs, '29' for Computers). See GovDeals category list for all codes." }, "makebrand": { "title": "Make / Brand", "type": "string", "description": "Filter by manufacturer or brand (e.g. 'Ford', 'Dell', 'Caterpillar')." }, "model": { "title": "Model", "type": "string", "description": "Filter by model name (e.g. 'F-150', 'Latitude', 'D6')." }, "modelYear": { "title": "Model Year", "type": "string", "description": "Filter by model year (e.g. '2020', '2019')." }, "locationState": { "title": "State", "type": "string", "description": "Filter by US state abbreviation (e.g. 'CA', 'TX', 'NY')." }, "auctionTypeId": { "title": "Auction Type", "type": "integer", "description": "Filter by auction type: 3=Online Auction, 4=Buy Now, 5=Make Offer, 1=Sealed Bid. Leave blank for all types." }, "sortField": { "title": "Sort Field", "enum": [ "currentBid", "location", "auctionEnd" ], "type": "string", "description": "Sort results by this field.", "default": "auctionEnd" }, "sortOrder": { "title": "Sort Order", "enum": [ "asc", "desc" ], "type": "string", "description": "Sort direction: 'asc' (ascending) or 'desc' (descending, newest/highest first).", "default": "desc" }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of parallel requests. Lower this if you get rate-limited.", "default": 5 }, "includeAssetDetails": { "title": "📋 Include asset details", "type": "boolean", "description": "Adds an assetDetails block to each listing: VIN or serial number, meter reading, title status, condition, full description, every photo, the attribute table, pickup address with coordinates, and the inspection, payment and removal instructions. It is one extra request per listing. Charged only for a row that receives it.", "default": false }, "includeSellerContact": { "title": "📞 Include seller contact", "type": "boolean", "description": "Adds a sellerContact block to each listing: the agency contact name, email, phone, organization, website and seller page. It is one extra request per listing, shared with asset details when both are on. Charged only for a row that receives an email or a phone.", "default": false }, "includeBidHistory": { "title": "🔨 Include bid history", "type": "boolean", "description": "Adds the full bid ladder to each listing as bidHistory (amount, masked bidder, time, winning flag) plus bidCount. It is one extra request per listing. Charged only for a row that receives at least one bid.", "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 }, "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 } } } } } } } } } }