{ "openapi": "3.0.1", "info": { "title": "USDA Livestock Auction Reports: Cattle Prices and Report Dates", "description": "Collect official USDA AMS livestock auction reports: titles, publication dates, correction flags, and source documents, free with no login. Add your own free USDA MyMarketNews key to also pull structured cattle and feeder cattle prices. Export to JSON, CSV, or Excel. Pay only per saved result.", "version": "1.0", "x-build-id": "jEJn1B5qfGMt080Yi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~usda-livestock-auction-results-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-usda-livestock-auction-results-feed", "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/getascraper~usda-livestock-auction-results-feed/runs": { "post": { "operationId": "runs-sync-getascraper-usda-livestock-auction-results-feed", "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/getascraper~usda-livestock-auction-results-feed/run-sync": { "post": { "operationId": "run-sync-getascraper-usda-livestock-auction-results-feed", "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": { "reportIds": { "title": "Exact USDA Report IDs", "maxItems": 100, "type": "array", "description": "Optional positive numeric report IDs. When supplied, title keywords are ignored.", "items": { "type": "integer", "minimum": 1 }, "default": [] }, "daysBack": { "title": "Publication Window in Days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Return reports published during the last 1 to 30 days.", "default": 7 }, "reportKeywords": { "title": "Report Title Keywords", "maxItems": 25, "type": "array", "description": "Keep reports whose official title contains any keyword. Exact report IDs take precedence when supplied.", "items": { "type": "string", "maxLength": 100 }, "default": [ "Livestock Auction", "Stockyards", "Feeder Cattle", "Slaughter/Replacement Cattle", "Cattle Auction", "Sheep and Goat Auction" ] }, "includeMarketRows": { "title": "Include Structured MARS Market Rows", "type": "boolean", "description": "Add source rows behind each selected report when a USDA MARS API key is supplied. Report metadata still returns without a key.", "default": true }, "marsApiKey": { "title": "USDA MARS API Key", "type": "string", "description": "Optional personal USDA MyMarketNews key. It is required only for structured market rows and is never written to output or logs." }, "maxReports": { "title": "Maximum Reports", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum published-report records to return after filtering.", "default": 10 }, "maxRowsPerReport": { "title": "Maximum Market Rows per Report", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum structured MARS rows returned for each report when enrichment is available.", "default": 10 } } }, "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 } } } } } } } } } }