🐄 USDA Livestock Auction Results Feed

Get newly published USDA livestock auction reports ready for research in seconds. Collect official report titles, dates, correction flags, reporting periods, and direct USDA documents from one bounded run.

🏛️ Official source Trace every record to USDA AMS

📅 Source dates Keep publication and report periods

🔎 Precise filters Use titles or exact report IDs

📊 Optional rows Add MARS data with your own key

USDA Livestock Auction Results Feed turns the official Agricultural Marketing Service publication feed into clean, source-linked records. No source login is needed for report metadata.

🔍 What does this Actor do?

The Actor checks the official USDA AMS list of recently published reports. It keeps livestock auction reports that match your keywords or exact report IDs.

Each report record includes its official title, publication time, covered dates, correction status, file details, and direct USDA document link. Users with a MyMarketNews key can also request the structured source rows behind selected reports.

The output also preserves the publication feed's own generation time and declared report count. Structured MARS rows inherit the complete report provenance, so a row can be traced without joining it back to a separate report item.

The Actor does not estimate prices or fill missing fields. It returns only values supplied by USDA.

👥 Why use it?

• I am a cattle market analyst comparing official sale reports without checking many USDA pages by hand.
• I am an agricultural economist collecting repeatable publication records with source dates and direct documents.
• I am a livestock buyer tracking newly released feeder cattle and stockyard reports for scheduled review.
• I am a data product manager adding official USDA records to a research feed without maintaining source collection code.

🚀 How to use it

STEP 1 Choose reports Keep the guided keywords or enter exact USDA IDs.

STEP 2 Set finite limits Pick the publication window and maximum records.

STEP 3 Run or schedule Export the dataset or repeat the feed on a schedule.

🎛️ Input

Field	Type	Required	Description
reportIds	array of numbers	No	Exact positive USDA report IDs. When provided, these take precedence over title keywords.
daysBack	integer	No	Publication window from 1 to 30 days. It defaults to the latest 7 days.
reportKeywords	array of strings	No	Case-insensitive phrases matched against official report titles. Guided livestock terms are provided.
includeMarketRows	boolean	No	Adds structured MARS rows when a personal USDA key is available. Report metadata still returns without a key.
marsApiKey	string	No	Personal MyMarketNews key used only for optional structured rows. It is never saved to the dataset.
maxReports	integer	No	Finite cap on matching report records. It defaults to 10 reports.
maxRowsPerReport	integer	No	Finite cap on optional MARS rows for each selected report. It defaults to 10 rows.

📦 Output example

{
    "recordType": "report",
    "reportId": 1280,
    "fileName": "ams_1280",
    "fileExtension": "pdf",
    "publishedDateText": "2026-08-10 11:56:55 MDT",
    "publishedAtEpochMs": 1786384615723,
    "publishedAt": "2026-08-10T17:56:55.723Z",
    "reportBeginDate": "2026-08-10",
    "reportEndDate": "2026-08-10",
    "isCorrection": false,
    "title": "Oklahoma National Stockyards Feeder Cattle - Oklahoma City, OK",
    "sourceGeneratedDateText": "2026-08-10 12:15:59 MDT",
    "sourceTotalReports": 2,
    "sourceDocumentUrl": "https://www.ams.usda.gov/mnreports/ams_1280.pdf",
    "sourceListUrl": "https://marsapi.ams.usda.gov/services/v1.1/public/listPublishedReports/7",
    "scrapedAt": "2026-08-10T18:15:59.000Z"
}

🧾 Data table

Field	Type	Description
recordType	string	Distinguishes a published report from an optional structured market row.
reportId	number	USDA report identifier from the official publication feed.
fileName	string	Source-provided USDA document file name.
fileExtension	string	Source-provided document format, such as pdf or txt.
publishedDateText	string	Original USDA publication date and timezone text.
publishedAtEpochMs	number	Source publication timestamp in milliseconds.
publishedAt	string	Publication timestamp formatted as ISO 8601.
reportBeginDate	string	Beginning of the reporting period supplied by USDA.
reportEndDate	string	End of the reporting period supplied by USDA.
isCorrection	boolean	Whether USDA marks the publication as a correction.
title	string	Official USDA report title.
sourceDocumentUrl	string	Direct link to the official report document.
sourceListUrl	string	Official published-report feed used for the run.
sourceGeneratedDateText	string	Original generation time printed by the official USDA feed.
sourceTotalReports	number	Total report count declared by the official feed before filtering.
rowNumber	number	Position of an optional MARS row within its selected report.
marketData	object	Source-backed structured row returned by USDA MARS. MARS rows also include the report file, dates, correction flag, and feed provenance fields above.
scrapedAt	string	Time the record was collected.

The Output tab includes separate views for published reports, structured MARS rows, and source provenance.

💰 Pricing

Pricing is pay per saved result. Empty runs cost nothing, and there is no fixed subscription.

⭐ Enjoying USDA Livestock Auction Results Feed?

⭐ ⭐ ⭐ ⭐ ⭐ Spend less time finding official livestock reports. A 5-star rating takes 10 seconds and helps agricultural analysts find this Actor. Your feedback also guides the next release.

★  Rate this Actor on Apify

ℹ️ Source scope and limitations

• Public report metadata comes from the official USDA AMS updated-reports feed.
• Structured market rows require your personal MyMarketNews key. The Actor does not provide or share keys.
• Report coverage depends on titles published by USDA within your chosen window.
• Direct documents may be PDF or text files. This release does not parse document body tables without MARS data.
• USDA is the source of record. This Actor is independent and is not affiliated with USDA.

❓ FAQ

Does the USDA livestock report feed require a login?

No. Published-report metadata and document links are public. Only optional structured MARS rows require your own USDA MyMarketNews key.

How fresh is the livestock auction data?

Each run reads the current official publication list for your selected 1 to 30 day window. Output preserves the USDA publication timestamp.

Does this Actor collect private data?

No. It collects official market report metadata, public documents, and optional rows returned through an authorized USDA key.

Which livestock reports are supported?

You can match any title in the official feed. The guided defaults target auctions, stockyards, feeder cattle, and slaughter or replacement cattle reports.

🔗 Other actors

• AuctionNinja Scraper: Estate Sales & Online Auctions ↗ - Collect estate sale and online auction listings.
• ShopGoodwill Scraper: Sold Comps & Auction Monitor ↗ - Track ShopGoodwill listings and sold comparables.
• LandAndFarm scraper: US land listings and broker leads ↗ - Collect rural land listings and broker details.
• Federal Register RAG Extractor: Rules, EOs & CFR Chunking ↗ - Prepare official federal publications for research workflows.