{ "openapi": "3.0.1", "info": { "title": "USDA Cattle Market Report Scraper", "description": "Scrape USDA cattle market reports into flat rows with class, grade, head count, weight range and weighted average price. Export to CSV, Excel, JSON or XML.", "version": "0.2", "x-build-id": "FlNdIuJdDm17fdKTe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~usda-cattle-market-report-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-usda-cattle-market-report-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~usda-cattle-market-report-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-usda-cattle-market-report-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~usda-cattle-market-report-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-usda-cattle-market-report-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": { "startUrls": { "title": "Report URLs", "type": "array", "description": "Optional. My Market News report pages such as https://mymarketnews.ams.usda.gov/viewReport/2481. Each URL adds its report to the ones picked below. Leave empty to use the report list only.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "reportSlugs": { "title": "USDA cattle reports", "type": "array", "description": "USDA Livestock Mandatory Reporting cattle reports to pull. Every value is a live AMS report slug verified against the public Market News datamart.", "items": { "type": "string", "enum": [ "AMS_2466", "AMS_2468", "AMS_2469", "AMS_2470", "AMS_2471", "AMS_2472", "AMS_2474", "AMS_2475", "AMS_2476", "AMS_2477", "AMS_2478", "AMS_2479", "AMS_2481", "AMS_2482", "AMS_2483", "AMS_2484", "AMS_2485", "AMS_2487", "AMS_2488", "AMS_2489", "AMS_2656", "AMS_2659", "AMS_2660", "AMS_2661", "AMS_2662", "AMS_2663", "AMS_2664", "AMS_2665", "AMS_2666", "AMS_2667", "AMS_2668", "AMS_2671", "AMS_2672", "AMS_2685", "AMS_2686", "AMS_2687", "AMS_2688", "AMS_2689", "AMS_2690", "AMS_2691", "AMS_2692", "AMS_2693", "AMS_2694", "AMS_2695", "AMS_2696", "AMS_3494", "AMS_3495", "AMS_3496", "AMS_3497", "AMS_3498", "AMS_3499", "AMS_3500", "AMS_3501", "AMS_3502", "AMS_3503", "AMS_3504", "AMS_3505", "AMS_3506", "AMS_3507" ], "enumTitles": [ "5 Area Daily Weighted Average Direct Slaughter Cattle - Negotiated (LM_CT100)", "Direct Slaughter Cow and Bull Report - Plant Delivered Bids (LM_CT138)", "TX-OK-NM Weekly Direct Slaughter Cattle - Formula, Grid and Contract Purchases (LM_CT139)", "Kansas Weekly Directly Slaughter Cattle - Formula, Grid and Contract Purchases (LM_CT140)", "Nebraska Weekly Directly Slaughter Cattle-Formula, Grid and Contract Purchases (LM_CT141)", "Weekly Direct Slaughter Cattle - Committed and Delivered Cattle (LM_CT142)", "5 Area Weekly Direct Slaughter Cattle - Formulated, Forward Contract, and Negotiated Grid Purchases (LM_CT145)", "CO Weekly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT146)", "IA-MN Weekly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT147)", "5 Area Weekly Weighted Average Direct Slaughter Cattle (LM_CT150)", "National Weekly Direct Slaughter Cattle Report - Formulated and Forward Contract (LM_CT151)", "National Weekly Direct Slaughter Cattle Report - Formulated and Forward Contract - Imported (LM_CT152)", "National Weekly Direct Slaughter Cattle - Negotiated Purchases (LM_CT154)", "National Weekly Direct Slaughter Cattle - Premiums and Discounts (LM_CT155)", "Texas-Oklahoma Weekly Direct Slaughter Cattle - Negotiated Purchases (LM_CT156)", "Kansas Weekly Direct Slaughter Cattle - Negotiated Purchases (LM_CT157)", "Nebraska Weekly Direct Slaughter Cattle - Negotiated Purchases (LM_CT158)", "Iowa/Minnesota Weekly Weighted Average Cattle Report - Negotiated Purchases (LM_CT167)", "National Weekly Direct Cow and Bull Report - Negotiated Price (LM_CT168)", "5 Area Weekly Weighted Average Direct Slaughter Cattle Premium and Discounts (LM_CT169)", "National Daily Slaughter Cattle - Committed and Delivered Cattle - Summary (LM_CT106)", "National Daily Direct Slaughter Cattle Report - Formulated Purchases - Summary (LM_CT109)", "National Daily Direct Slaughter Cattle Report - Negotiated Purchases - AM (LM_CT113)", "National Daily Direct Slaughter Cattle Report - Negotiated Purchases - PM (LM_CT114)", "National Daily Direct Slaughter Cattle Report - Negotiated Purchases - Summary (LM_CT115)", "TX/OK/NM Daily Direct Slaughter Cattle - Negotiated Purchases - Afternoon (LM_CT117)", "TX/OK/NM Daily Direct Slaughter Cattle - Negotiated Purchases - Summary (LM_CT118)", "Kansas Daily Direct Slaughter Cattle - Negotiated Purchases - Afternoon (LM_CT120)", "Kansas Daily Direct Slaughter Cattle - Negotiated Purchases - Summary (LM_CT121)", "Nebraska Daily Direct Slaughter Cattle - Negotiated Purchases - Afternoon (LM_CT123)", "Nebraska Daily Direct Slaughter Cattle - Negotiated Purchases - Summary (LM_CT124)", "IA-MN Daily Direct Slaughter Cattle - Negotiated Purchases - Afternoon (LM_CT136)", "IA-MN Daily Direct Slaughter Cattle - Negotiated Purchases - Summary (LM_CT137)", "5 Area Monthly Weighted Average Direct Slaughter - Negotiated (LM_CT180)", "Texas/Oklahoma Monthly Weighted Average Cattle Report - Negotiated Purchases (LM_CT181)", "Kansas Monthly Weighted Average Cattle Report - Negotiated Purchases (LM_CT182)", "Nebraska Monthly Weighted Average Cattle Report - Negotiated Purchases (LM_CT183)", "Colorado Monthly Weighted Average Cattle Report - Negotiated Purchases (LM_CT184)", "Iowa/Minnesota Monthly Weighted Average Cattle Report - Negotiated Purchases (LM_CT185)", "5 Area Monthly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT186)", "TX-OK-NM Monthly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT187)", "KS Monthly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT188)", "NE Monthly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT189)", "CO Monthly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT190)", "IA-MN Monthly Direct Slaughter Cattle - Formula, Grid, and Contract Purchases (LM_CT191)", "Direct Slaughter Cattle - Formulated Base Purchases - Morning", "Direct Slaughter Cattle - Formulated Base Purchases - Afternoon", "Direct Slaughter Cattle - Formulated Base Purchases - Summary", "TX-OK-NM Weekly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "Kansas Weekly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "Nebraska Weekly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "Colorado Weekly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "IA-MN Weekly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "National Weekly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "TX-OK-NM Monthly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "Kansas Monthly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "Nebraska Monthly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "Colorado Monthly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases", "IA-MN Monthly Direct Slaughter Cattle - Formulated Base and Forward Contract Base Purchases" ] }, "default": [ "AMS_2481" ] }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "lastDays": { "title": "Look back (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "How far back to pull report dates. USDA serves the full published history, so a larger window returns more rows. Daily reports publish every weekday, weekly reports every Monday, monthly reports once a month.", "default": 30 }, "dateFrom": { "title": "From date", "type": "string", "description": "Optional. Earliest report date to keep, as YYYY-MM-DD. Overrides the look back window when set." }, "dateTo": { "title": "To date", "type": "string", "description": "Optional. Latest report date to keep, as YYYY-MM-DD. Defaults to today." }, "cattleClass": { "title": "Cattle class", "type": "array", "description": "Keep only these cattle classes. Matching ignores letter case, so STEER and Steer both match. Leave empty for every class.", "items": { "type": "string", "enum": [ "Steer", "Heifer", "Mixed Steer/Heifer", "Mixed Steer/Heifer/Cow", "Dairybred Steer/Heifer", "All Beef Type", "All Steers & Heifers" ], "enumTitles": [ "Steer", "Heifer", "Mixed steer/heifer", "Mixed steer/heifer/cow", "Dairybred steer/heifer", "All beef type", "All steers and heifers" ] }, "default": [] }, "grade": { "title": "Quality grade", "type": "array", "description": "Keep only these USDA quality grade bands. Leave empty for every grade.", "items": { "type": "string", "enum": [ "Over 80% Choice", "65 - 80% Choice", "35 - 65% Choice", "0 - 35% Choice", "Total all grades" ], "enumTitles": [ "Over 80% Choice", "65 to 80% Choice", "35 to 65% Choice", "0 to 35% Choice", "Total all grades" ] }, "default": [] }, "sellingBasis": { "title": "Selling basis", "type": "array", "description": "Keep only live weight or dressed weight rows. Leave empty for both.", "items": { "type": "string", "enum": [ "Live", "Dressed" ], "enumTitles": [ "Live weight", "Dressed weight" ] }, "default": [] }, "includeNoSaleRows": { "title": "Include rows with no reported sales", "type": "boolean", "description": "USDA prints a placeholder line for every class and grade combination, including the ones with no confirmed trade that day. Turn this on to keep those empty lines. Off by default so every delivered row carries a head count or a price.", "default": false }, "marsApiKey": { "title": "API key", "type": "string", "description": "Optional. Free My Market News (MARS) API key. Register at https://mymarketnews.ams.usda.gov/mymarketnews-api/authentication to unlock the full AMS report catalog through marsapi.ams.usda.gov. Leave empty to use the open Market News datamart, which needs no key.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "USDA Market News answers plain requests, so the proxy is off by default. Turn it on only when you run very high volume from one account.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }