Reference · built on requestCommons signalEconomic & calendar reference

USDA AMS Market News (MARS API)

Daily and weekly commodity prices and volumes from USDA Market News reports, through the MARS REST API with a free key.

Request accessPricing ↗

About

USDA Market News is the Agricultural Marketing Service's price and sales reporting program. Its offices publish thousands of reports a year on livestock, poultry, grain, dairy, fruits, vegetables, specialty crops, cotton, tobacco, organic, and local foods. My Market News is the portal, and the MARS API at marsapi.ams.usda.gov/services/v1.2/reports serves each report's data as JSON. You address a report by its slug_id or slug_name, then filter by commodity, date, or any field in the response.

On Fibric, an operator reads the reports behind your purchase prices, compares the day's quotes with your price list or cost model, and proposes a price review or a purchase order for your approval.

This is a reference listing. It documents what Fibric would read from USDA AMS Market News (MARS API) and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • The reports table of contents at /services/v1.2/reports: each report's slug_id, slug_name, and report_name
  • A single report by /reports/<slug_id> or /reports/<slug_name>, sorted by report date descending by default
  • Report sections by /reports/<slug_id>/<Section>, for example Details or Volumes, with allSections=true for a whole report
  • Filters with q=field=value, comma lists, semicolon-joined fields, and colon date ranges such as report_begin_date=06/06/2017:07/01/2017
  • Reference lists at /offices, /marketTypes, and /commodities, and the reports each office or market type publishes
  • Corrections through correctionsOnly=true and anyChangesSince=yyyy/mm/dd, and public v1.1 lists of published and corrected reports

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Reprice a menu or catalog from the day's report

    Read the report behind each purchased commodity after it publishes. The operator compares the quoted price with your cost sheet and proposes a price-list change, with the report date and slug_id on the record.

    With Price List Drift, Unit Cost

  • Draft a purchase order at the right moment

    Pull a week of report_begin_date rows for a commodity. When the quote drops below your reorder threshold, the operator drafts the purchase order and hands it to the buyer.

    With Purchase Order Draft

  • Put livestock and produce quotes in the morning brief

    Each morning the operator lists the reports that published overnight, the headline prices, and any corrections since the last run, and leaves a link to each report.

    With Morning Brief

Requirements

  • A USDA eAuthentication login and a My Market News account to obtain an API key
  • HTTPS on every call; plain HTTP and unauthenticated requests fail
  • The slug_id or slug_name of each report you want; the API does not search one commodity across reports
  • Both a start and an end date on date-range filters; open-ended ranges are not accepted
Authentication
A personal API key from a My Market News account. You register through USDA eAuthentication, reveal the key under your name, and send it as the HTTP Basic username with no password.

Limits

  • Registered users can pull 100,000 rows per request; unregistered callers on the sample key are limited to 5,000
  • There are no webhooks; you poll the reports or the public listPublishedReports index
  • URL parameters are case sensitive; correctionsonly is ignored where correctionsOnly works
  • AMS says commodities are still being moved into MARS one at a time, so not every Market News report is in the API

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request USDA AMS Market News (MARS API) ↗

Questions and answers

How do I authenticate to the MARS API?
Register through USDA eAuthentication, log in to My Market News, and click Show API key under your name. Send the key as the Basic authentication username with no password, over HTTPS. AMS says each key is unique to one account and must not be shared.
Is there a rate limit?
AMS says it does not limit the number of queries in a time frame. It limits rows per call: 100,000 for registered users and 5,000 for unregistered callers on the sample key. The API returns 429 when you have made too many requests.
Can I search by commodity across all reports?
No. AMS says you retrieve data by report, not by commodity, and cannot search a single commodity across reports. You can filter within a report by commodity, for example q=commodity=Feeder Cattle.
Ask about USDA AMS Market News (MARS API)

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by USDA Agricultural Marketing Service (mymarketnews.ams.usda.gov, marsapi.ams.usda.gov). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy