# USDA Livestock Auction Reports: Cattle Prices (`getascraper/usda-livestock-auction-results-feed`) Actor

Scrape official USDA livestock auction reports and feeder-cattle market data. Export report dates, corrections, PDF URLs, and optional MARS rows as JSON or CSV for pricing, procurement, and market research.

- **URL**: https://apify.com/getascraper/usda-livestock-auction-results-feed.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Other, Automation, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.30 / 1,000 auction reports

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🐄 USDA Livestock Auction Results Feed

<table width="100%">
<tr>
<td style="padding:24px 28px;background:#EFF6FF;border:1px solid #BFDBFE;border-top:4px solid #1D4ED8;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Get newly published USDA livestock auction reports ready for research in seconds.</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Collect official report titles, dates, correction flags, reporting periods, and direct USDA documents from one bounded run.</span>
</td>
</tr>
</table>

<table width="100%">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #BFDBFE;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1E3A8A">🏛️ Official source</span><br>
<span style="font-size:12px;color:#57534E">Trace every record to USDA AMS</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #BFDBFE;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1E3A8A">📅 Source dates</span><br>
<span style="font-size:12px;color:#57534E">Keep publication and report periods</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #BFDBFE;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1E3A8A">🔎 Precise filters</span><br>
<span style="font-size:12px;color:#57534E">Use titles or exact report IDs</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #BFDBFE;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1E3A8A">📊 Optional rows</span><br>
<span style="font-size:12px;color:#57534E">Add MARS data with your own key</span>
</td>
</tr>
</table>

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

<table width="100%">
<tr>
<td style="padding:16px 14px;width:33%;background:#EFF6FF;border:1px solid #BFDBFE;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1D4ED8;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Choose reports</span><br>
<span style="font-size:12px;color:#57534E">Keep the guided keywords or enter exact USDA IDs.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EFF6FF;border:1px solid #BFDBFE;border-left:none;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1D4ED8;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Set finite limits</span><br>
<span style="font-size:12px;color:#57534E">Pick the publication window and maximum records.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EFF6FF;border:1px solid #BFDBFE;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1D4ED8;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Run or schedule</span><br>
<span style="font-size:12px;color:#57534E">Export the dataset or repeat the feed on a schedule.</span>
</td>
</tr>
</table>

### 🎛️ 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

```json
{
    "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?

<table width="100%" style="display:table;width:100%">
<tr>
<td style="padding:20px 24px 14px;background:#EFF6FF;border:1px solid #BFDBFE;border-left:5px solid #1D4ED8;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px;color:#1C1917">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Spend less time finding official livestock reports.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps agricultural analysts find this Actor. Your feedback also guides the next release.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#1D4ED8;border:1px solid #BFDBFE;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/usda-livestock-auction-results-feed/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### ℹ️ 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](https://apify.com/getascraper/auctionninja-scraper) ↗ - Collect estate sale and online auction listings.
- [ShopGoodwill Scraper: Sold Comps & Auction Monitor](https://apify.com/getascraper/shopgoodwill-scraper) ↗ - Track ShopGoodwill listings and sold comparables.
- [LandAndFarm scraper: US land listings and broker leads](https://apify.com/getascraper/landandfarm-scraper) ↗ - Collect rural land listings and broker details.
- [Federal Register RAG Extractor: Rules, EOs & CFR Chunking](https://apify.com/getascraper/federal-register-rag-extractor) ↗ - Prepare official federal publications for research workflows.

# Actor input Schema

## `reportIds` (type: `array`):

Optional positive numeric report IDs. When supplied, title keywords are ignored.

## `daysBack` (type: `integer`):

Return reports published during the last 1 to 30 days.

## `reportKeywords` (type: `array`):

Keep reports whose official title contains any keyword. Exact report IDs take precedence when supplied.

## `includeMarketRows` (type: `boolean`):

Add source rows behind each selected report when a USDA MARS API key is supplied. Report metadata still returns without a key.

## `marsApiKey` (type: `string`):

Optional personal USDA MyMarketNews key. It is required only for structured market rows and is never written to output or logs.

## `maxReports` (type: `integer`):

Maximum published-report records to return after filtering.

## `maxRowsPerReport` (type: `integer`):

Maximum structured MARS rows returned for each report when enrichment is available.

## Actor input object example

```json
{
  "reportIds": [],
  "daysBack": 7,
  "reportKeywords": [
    "Livestock Auction",
    "Stockyards",
    "Feeder Cattle",
    "Slaughter/Replacement Cattle",
    "Cattle Auction",
    "Sheep and Goat Auction"
  ],
  "includeMarketRows": true,
  "maxReports": 10,
  "maxRowsPerReport": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "reportIds": [],
    "daysBack": 7,
    "reportKeywords": [
        "Livestock Auction",
        "Stockyards",
        "Feeder Cattle",
        "Slaughter/Replacement Cattle",
        "Cattle Auction",
        "Sheep and Goat Auction"
    ],
    "includeMarketRows": true,
    "maxReports": 10,
    "maxRowsPerReport": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/usda-livestock-auction-results-feed").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "reportIds": [],
    "daysBack": 7,
    "reportKeywords": [
        "Livestock Auction",
        "Stockyards",
        "Feeder Cattle",
        "Slaughter/Replacement Cattle",
        "Cattle Auction",
        "Sheep and Goat Auction",
    ],
    "includeMarketRows": True,
    "maxReports": 10,
    "maxRowsPerReport": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/usda-livestock-auction-results-feed").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "reportIds": [],
  "daysBack": 7,
  "reportKeywords": [
    "Livestock Auction",
    "Stockyards",
    "Feeder Cattle",
    "Slaughter/Replacement Cattle",
    "Cattle Auction",
    "Sheep and Goat Auction"
  ],
  "includeMarketRows": true,
  "maxReports": 10,
  "maxRowsPerReport": 10
}' |
apify call getascraper/usda-livestock-auction-results-feed --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/usda-livestock-auction-results-feed"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DNiuLP0AaYAMiaDmT/builds/1Srw5VYmHnVmccRp4/openapi.json