Agricultural Marketing Service website screenshot

Agricultural Marketing Service

The Agricultural Marketing Service (AMS), an agency of the United States Department of Agriculture (USDA), oversees programs in five commodity areas: cotton and tobacco, dairy, fruits and vegetables, livestock and seeds, and poultry. AMS provides testing, standardization, grading, and market news services. AMS operates several public APIs for agricultural market data including the Market Analysis Reporting System (MARS) API for real-time commodity market news and the Livestock Mandatory Price Reporting System (LMPRS) API for livestock price data.

Agricultural Marketing Service publishes 2 APIs on the APIs.io network: Offices API and Reports API. Tagged areas include Agriculture, Federal Government, Market News, Livestock, and Dairy.

The Agricultural Marketing Service catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Agricultural Marketing Service’s developer surface includes authentication, engineering blog, developer portal, and 10 more developer resources.

🌐 Visit website 📡 Source on GitHub
53.9/100 developing ▼ -6.8 Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
4 APIs 6 Features 5 Use Cases
AgricultureFederal GovernmentMarket NewsLivestockDairyFruits And VegetablesCottonTobacco

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 53.9/100 · developing
Contract Quality 16.1 / 25
Developer Ergonomics 5.2 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 7.4 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/agricultural-marketing-service: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

USDA Local Food Directories API

The USDA Local Food Directories API provides data sharing access to directory information for farmers markets, food hubs, on-farm markets, community supported agriculture (CSA) ...

Agricultural Marketing Service Offices API

USDA AMS market news offices

Agricultural Marketing Service Reports API

Agricultural market news reports across all commodity types

USDA AMS LMPRS API (Livestock Mandatory Price Reporting)

The Livestock Mandatory Price Reporting System (LMPRS) API provides programmatic access to federally mandated livestock price report data. The API requires no authentication for...

Postman Collections 2

Ready-to-run Postman collections for exercising this provider's APIs.

USDA AMS MARS API (MyMarketNews) Offices API

POSTMAN

USDA AMS MARS API (MyMarketNews) Offices Reports API

POSTMAN

Pricing Plans 1

Published pricing tiers and plan structures.

Agricultural Marketing Service Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Agricultural Marketing Service Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Agricultural Marketing Service Finops

FINOPS

Features 6

Notable capabilities this provider offers.

No Authentication Required

The MARS and LMPRS APIs are publicly accessible without authentication; registered users can obtain API keys for higher rate limits.

JSON Data Format

All API responses are returned in JSON format including errors and paginated results.

Real-Time Market News

MARS API provides up-to-date commodity price and volume data as reports are released by AMS market reporters.

Historical Data Access

Access up to 180 days of historical market data per request with up to 100,000 records returned per call.

Commodity Coverage

Market data covers livestock, dairy, fruits, vegetables, grains, cotton, tobacco, poultry, and other agricultural commodities.

Mandatory Price Reporting

LMPRS API provides federally mandated livestock price data under the Livestock Mandatory Reporting Act.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Agricultural Marketing Service Mars Api Context

9 classes · 25 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Agricultural Marketing Service API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Agricultural Marketing Service API Rules

29 rules · 10 errors 19 warnings

SPECTRAL

JSON Schema 8

Standalone JSON Schema definitions for this provider's data models.

Error Response

3 properties

JSON SCHEMA

Office

5 properties

JSON SCHEMA

Offices List Response

1 properties

JSON SCHEMA

Pagination Stats

2 properties

JSON SCHEMA

Report Data Response

2 properties

JSON SCHEMA

Report Data

11 properties

JSON SCHEMA

Report

8 properties

JSON SCHEMA

Reports List Response

2 properties

JSON SCHEMA

Scroll for all 8

JSON Structure 8

JSON Structure definitions describing this provider's data shapes.

Mars Api Error Response Structure

3 properties

JSON STRUCTURE

Mars Api Office Structure

5 properties

JSON STRUCTURE

Mars Api Offices List Response Structure

1 properties

JSON STRUCTURE

Mars Api Pagination Stats Structure

2 properties

JSON STRUCTURE

Mars Api Report Data Response Structure

2 properties

JSON STRUCTURE

Mars Api Report Data Structure

11 properties

JSON STRUCTURE

Mars Api Report Structure

8 properties

JSON STRUCTURE

Mars Api Reports List Response Structure

2 properties

JSON STRUCTURE

Scroll for all 8

Examples 8

Example request and response payloads for these APIs.

Mars Api Error Response Example

3 fields

EXAMPLE

Mars Api Office Example

5 fields

EXAMPLE

Mars Api Offices List Response Example

1 fields

EXAMPLE

Mars Api Pagination Stats Example

2 fields

EXAMPLE

Mars Api Report Data Example

11 fields

EXAMPLE

Mars Api Report Data Response Example

2 fields

EXAMPLE

Mars Api Report Example

8 fields

EXAMPLE

Mars Api Reports List Response Example

2 fields

EXAMPLE

Scroll for all 8

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Agricultural Marketing Service Authentication

http · 1 scheme

SECURITY

Agricultural Marketing Service Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Agricultural Marketing Service Agentic Access

3 operations

3 operations · 0 acting

AGENTIC

Use Cases 5

What developers build with this provider.

Agricultural Price Monitoring

Track commodity prices across livestock, dairy, fruits, and vegetables to support trading, purchasing, and production decisions.

Market Analysis and Research

Pull historical and current market news data for academic research, economic analysis, and policy work.

Supply Chain Integration

Integrate USDA market news data into supply chain management and procurement systems for real-time pricing.

Local Food System Mapping

Use the Local Food Directories API to locate and integrate data about farmers markets, CSAs, and food hubs.

Commodity Price Alerts

Build automated price monitoring systems using the MARS API to trigger alerts when prices cross defined thresholds.

Integrations 2

Pre-built integrations with other platforms and tools.

Microsoft Excel

USDA AMS provides guides for integrating MARS API data directly into Microsoft Excel for market analysis.

api.data.gov

AMS APIs are accessible through the federal api.data.gov gateway for consistent API key management.

Resources

Get Started 1

Portal, sign-up, and the first successful call

Portal
Portal

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

SpectralRules
SpectralRules
 Vocabulary
Vocabulary

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace
PostmanWorkspace
 GitHubOrganization
GitHubOrganization

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 3

The organization behind the API

Blog
Blog
 LinkedIn
LinkedIn
 Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: agricultural-marketing-service
url: https://raw.githubusercontent.com/api-evangelist/agricultural-marketing-service/refs/heads/main/apis.yml
name: Agricultural Marketing Service
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/agricultural-marketing-service.png
tags:
- Agriculture
- Federal Government
- Market News
- Livestock
- Dairy
- Fruits And Vegetables
- Cotton
- Tobacco
description: 'The Agricultural Marketing Service (AMS), an agency of the United States Department of Agriculture (USDA), oversees
  programs in five commodity areas: cotton and tobacco, dairy, fruits and vegetables, livestock and seeds, and poultry. AMS
  provides testing, standardization, grading, and market news services. AMS operates several public APIs for agricultural
  market data including the Market Analysis Reporting System (MARS) API for real-time commodity market news and the Livestock
  Mandatory Price Reporting System (LMPRS) API for livestock price data.'
created: '2024-11-21'
modified: '2026-07-25'
specificationVersion: '0.19'
apis:
- name: USDA Local Food Directories API
  description: The USDA Local Food Directories API provides data sharing access to directory information for farmers markets,
    food hubs, on-farm markets, community supported agriculture (CSA) operations, and food cooperatives across the United
    States.
  humanURL: https://www.usdalocalfoodportal.com/fe/datasharing/
  baseURL: https://www.usdalocalfoodportal.com
  tags:
  - Local Food
  - Farmers Markets
  - Food Hubs
  - CSA
  - Agriculture
  properties:
  - type: Documentation
    url: https://www.usdalocalfoodportal.com/fe/datasharing/
  - type: DataAPI
    url: https://www.usdalocalfoodportal.com/api/
- aid: agricultural-marketing-service:agricultural-marketing-service-offices-api
  name: Agricultural Marketing Service Offices API
  description: USDA AMS market news offices
  humanURL: https://mymarketnews.ams.usda.gov/mymarketnews-api
  baseURL: https://marsapi.ams.usda.gov/services/v1.2
  tags:
  - Offices
  properties:
  - type: OpenAPI
    url: openapi/agricultural-marketing-service-offices-api-openapi.yml
  - type: Documentation
    url: https://mymarketnews.ams.usda.gov/mymarketnews-api
  - type: GettingStarted
    url: https://mymarketnews.ams.usda.gov/mars-api/getting-started
  - type: Authentication
    url: https://mymarketnews.ams.usda.gov/mymarketnews-api/authentication
  - type: JSONSchema
    url: json-schema/mars-api-report-schema.json
  - type: JSONSchema
    url: json-schema/mars-api-report-data-schema.json
  - type: JSONSchema
    url: json-schema/mars-api-office-schema.json
  - type: JSONStructure
    url: json-structure/mars-api-report-structure.json
  - type: JSONStructure
    url: json-structure/mars-api-report-data-structure.json
  - type: JSONLD
    url: json-ld/agricultural-marketing-service-mars-api-context.jsonld
- aid: agricultural-marketing-service:agricultural-marketing-service-reports-api
  name: Agricultural Marketing Service Reports API
  description: Agricultural market news reports across all commodity types
  humanURL: https://mymarketnews.ams.usda.gov/mymarketnews-api
  baseURL: https://marsapi.ams.usda.gov/services/v1.2
  tags:
  - Reports
  properties:
  - type: OpenAPI
    url: openapi/agricultural-marketing-service-reports-api-openapi.yml
  - type: Documentation
    url: https://mymarketnews.ams.usda.gov/mymarketnews-api
  - type: GettingStarted
    url: https://mymarketnews.ams.usda.gov/mars-api/getting-started
  - type: Authentication
    url: https://mymarketnews.ams.usda.gov/mymarketnews-api/authentication
  - type: JSONSchema
    url: json-schema/mars-api-report-schema.json
  - type: JSONSchema
    url: json-schema/mars-api-report-data-schema.json
  - type: JSONSchema
    url: json-schema/mars-api-office-schema.json
  - type: JSONStructure
    url: json-structure/mars-api-report-structure.json
  - type: JSONStructure
    url: json-structure/mars-api-report-data-structure.json
  - type: JSONLD
    url: json-ld/agricultural-marketing-service-mars-api-context.jsonld
- name: USDA AMS LMPRS API (Livestock Mandatory Price Reporting)
  description: The Livestock Mandatory Price Reporting System (LMPRS) API provides programmatic access to federally mandated
    livestock price report data. The API requires no authentication for public access and returns JSON data. The LMPRS API
    covers cattle, hogs, lambs, and other livestock price reporting as required by the Livestock Mandatory Reporting Act.
  humanURL: https://mpr.datamart.ams.usda.gov/
  baseURL: https://mpr.datamart.ams.usda.gov
  tags:
  - Livestock
  - Price Reporting
  - Cattle
  - Hogs
  - Agriculture
  properties:
  - type: Documentation
    url: https://www.ams.usda.gov/sites/default/files/media/USDA_LMPRS_API_User_Guide.pdf
    title: LMPRS API User Guide
  - type: DataAPI
    url: https://mpr.datamart.ams.usda.gov/
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/agricultural-marketing-service/overview
- type: AgenticAccess
  url: agentic-access/agricultural-marketing-service-agentic-access.yml
- type: DomainSecurity
  url: security/agricultural-marketing-service-domain-security.yml
- type: Authentication
  url: authentication/agricultural-marketing-service-authentication.yml
- url: https://www.ams.usda.gov/rss.xml
  type: Blog
- type: LinkedIn
  url: https://www.linkedin.com/company/amsusda
- type: Website
  url: https://www.ams.usda.gov/
- type: Portal
  url: https://www.ams.usda.gov/resources/apis-open-data
- type: GitHubOrganization
  url: https://github.com/usda
- type: TermsOfService
  url: https://www.usda.gov/policies-and-links
- type: PrivacyPolicy
  url: https://www.usda.gov/privacy-policy
- type: SpectralRules
  url: rules/agricultural-marketing-service-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/agricultural-marketing-service-vocabulary.yaml
- type: Features
  data:
  - name: No Authentication Required
    description: The MARS and LMPRS APIs are publicly accessible without authentication; registered users can obtain API keys
      for higher rate limits.
  - name: JSON Data Format
    description: All API responses are returned in JSON format including errors and paginated results.
  - name: Real-Time Market News
    description: MARS API provides up-to-date commodity price and volume data as reports are released by AMS market reporters.
  - name: Historical Data Access
    description: Access up to 180 days of historical market data per request with up to 100,000 records returned per call.
  - name: Commodity Coverage
    description: Market data covers livestock, dairy, fruits, vegetables, grains, cotton, tobacco, poultry, and other agricultural
      commodities.
  - name: Mandatory Price Reporting
    description: LMPRS API provides federally mandated livestock price data under the Livestock Mandatory Reporting Act.
- type: UseCases
  data:
  - name: Agricultural Price Monitoring
    description: Track commodity prices across livestock, dairy, fruits, and vegetables to support trading, purchasing, and
      production decisions.
  - name: Market Analysis and Research
    description: Pull historical and current market news data for academic research, economic analysis, and policy work.
  - name: Supply Chain Integration
    description: Integrate USDA market news data into supply chain management and procurement systems for real-time pricing.
  - name: Local Food System Mapping
    description: Use the Local Food Directories API to locate and integrate data about farmers markets, CSAs, and food hubs.
  - name: Commodity Price Alerts
    description: Build automated price monitoring systems using the MARS API to trigger alerts when prices cross defined thresholds.
- type: Integrations
  data:
  - name: Microsoft Excel
    description: USDA AMS provides guides for integrating MARS API data directly into Microsoft Excel for market analysis.
  - name: api.data.gov
    description: AMS APIs are accessible through the federal api.data.gov gateway for consistent API key management.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com