{ "openapi": "3.0.1", "info": { "title": "Bring a Trailer New Auction Monitor", "description": "Watch Bring a Trailer for new auctions matching your keywords. Get only genuinely new listings with current bid and closing time, never the same auction twice. Built for bidders who track specific makes and models.", "version": "0.0", "x-build-id": "08MSKV8Xh1foaTRBz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delta_tools~bringatrailer-new-auction-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delta_tools-bringatrailer-new-auction-monitor", "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/delta_tools~bringatrailer-new-auction-monitor/runs": { "post": { "operationId": "runs-sync-delta_tools-bringatrailer-new-auction-monitor", "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/delta_tools~bringatrailer-new-auction-monitor/run-sync": { "post": { "operationId": "run-sync-delta_tools-bringatrailer-new-auction-monitor", "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": { "endingWithinHours": { "title": "Ending soon window in hours", "minimum": 1, "maximum": 168, "type": "integer", "description": "Auctions closing within this many hours are flagged as ending soon in the results. Use it to spot the listings that need a bid decision today.", "default": 24 }, "keywords": { "title": "Keywords to watch", "maxItems": 25, "type": "array", "description": "Makes, models, or phrases to watch for. Examples: Porsche, Ford Bronco, air cooled. A new auction matches when any keyword appears in its title or listing text. Matching ignores letter case. Leave empty to run a quick demo with a sample keyword.", "items": { "type": "string" } }, "maxCurrentBid": { "title": "Maximum current bid in USD", "type": "integer", "description": "Only report new auctions whose current bid in US dollars is at or below this amount. Leave empty for no maximum." }, "maxResults": { "title": "Max new auctions per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of new auctions to report in one run, soonest closing first. Auctions beyond the cap are not lost: they stay unreported and surface on the next run.", "default": 100 }, "minCurrentBid": { "title": "Minimum current bid in USD", "type": "integer", "description": "Only report new auctions whose current bid in US dollars is at or above this amount. Leave empty for no minimum." }, "reportInitialAsNew": { "title": "Report current matches on the first run", "type": "boolean", "description": "When on, the first run of a watch reports the auctions that already match, so you see the current field right away. When off, the first run only sets the baseline and later runs report what is genuinely new from then on.", "default": true }, "stateKey": { "title": "Watch name (advanced)", "type": "string", "description": "Name your watch to give it its own memory. Runs that share a watch name share dedup state, so a scheduled watch only ever reports genuinely new auctions. Leave empty for a fresh snapshot that resets daily, which suits one off trials." } } }, "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 } } } } } } } } } }