{ "openapi": "3.0.1", "info": { "title": "GSA Auctions Scraper - Federal Surplus Vehicles & Equipment", "description": "Live federal surplus lots from the official GSA Auctions API: vehicles, heavy equipment, electronics and more. Lot name, current bid, bidders, auction start and end, location and agency, newest first. Filter by keyword, state, closing date and price. Sales contacts off by default.", "version": "0.2", "x-build-id": "soj6kSvghdkXRQi2e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groundplanes~gsa-auctions-surplus-lots/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groundplanes-gsa-auctions-surplus-lots", "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/groundplanes~gsa-auctions-surplus-lots/runs": { "post": { "operationId": "runs-sync-groundplanes-gsa-auctions-surplus-lots", "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/groundplanes~gsa-auctions-surplus-lots/run-sync": { "post": { "operationId": "run-sync-groundplanes-gsa-auctions-surplus-lots", "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": { "keyword": { "title": "Keyword Filter", "type": "string", "description": "Case-insensitive keyword matched against itemName and lotInfo description (e.g. 'truck', 'ford', 'boat', 'tractor'). Leave empty for all active lots.", "default": "" }, "states": { "title": "Property States", "type": "array", "description": "Two-letter US state/territory codes where the surplus property is located (e.g. ['CA', 'TX', 'VA']). Leave empty for all states.", "items": { "type": "string" }, "default": [] }, "endingWithinDays": { "title": "Ending Within Days", "minimum": 0, "type": "integer", "description": "Keep only auctions ending within this many days from today. Set to 0 for no limit.", "default": 0 }, "maxCurrentBidUsd": { "title": "Maximum Current Bid (USD)", "minimum": 0, "type": "integer", "description": "Keep only lots where the current high bid (or 0 if no bids yet) is at or below this USD amount. Set to 0 for no limit.", "default": 0 }, "agencyKeyword": { "title": "Agency / Bureau Keyword", "type": "string", "description": "Case-insensitive keyword matched against the reporting federal agencyName or bureauName.", "default": "" }, "sortBy": { "title": "Sort Order", "enum": [ "NEWEST", "ENDING_SOON" ], "type": "string", "description": "Sort lots newest first by auctionStart date (NEWEST) or soonest closing first by auctionEnd date (ENDING_SOON).", "default": "NEWEST" }, "includeSalesContact": { "title": "Include Federal Sales Contracting Officer Contact", "type": "boolean", "description": "Defaults to false to omit federal contracting officer personal contact fields (contractOfficer, coEmail, coPhone) unless explicitly needed for auction inspection/inquiries.", "default": false }, "dataGovApiKey": { "title": "api.data.gov API Key (Optional)", "type": "string", "description": "Optional free api.data.gov key. If you provide one, the Actor uses yours. If you leave this blank, the Actor uses the account DATA_GOV_API_KEY secret when one is attached; otherwise it falls back to the public DEMO_KEY, which api.data.gov rate-limits per IP address, so heavy or scheduled use should add your own free key." }, "maxItems": { "title": "Maximum Items", "minimum": 1, "type": "integer", "description": "Maximum number of GSA auction lots to return.", "default": 200 } } }, "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 } } } } } } } } } }