Important Note: All URL parameters are case sensitive. For example:

This URL https://marsapi.ams.usda.gov/services/v3.0/reports/1280?correctionsOnly=true will return corrections only for report 1280.
This URL https://marsapi.ams.usda.gov/services/v3.0/reports/1280?correctionsonly=true will not return correct result because of case sensitivity on parameter. API will ignore. 

Example :

There are three major steps when using the API:

1. 1. Retrieve the MyMarketNews API endpoint using your personal API key from My Market News.
2. 2. Write code for your software that specifies which data sets to pull from MyMarketNews API.
3. 3. Download and use the data in your software.

Important Note: The MyMarketNews API does not support open web browser calls.

API Endpoint:  https://marsapi.ams.usda.gov/services/v1.1/reports

1. Register and log in to My Market News (see Authentication for more information)

2. Obtain your personal API Key found in My Profile

3. Open your tool that supports API calls* 

4. Enter in the API endpoint into your tool. See the endpoint below 

5. Enter your personal API Key  

API Endpoint:  https://marsapi.ams.usda.gov/

For more information, please visit our General Resources page

Hyper Text Transfer Protocol (HTTP) is an information exchanging procedure standard between 2 communicating parties or computers, such as the client and the server. While you type a URL address in the web browser, the browser will have to know the protocol to use when fetching the remote resource such as a web page or a picture at that address.

Hyper Text Transfer Protocol Secure (HTTPS) is the secure version of HTTP, the protocol over which data is sent between your browser and the website that you are connected to. The 'S' at the end of HTTPS stands for 'Secure'. It means all communications between your browser and the website are encrypted. HTTPS is often used to protect highly confidential online transactions like online banking and online shopping order forms.

JSON (JavaScript Object Notation) is a readable format for structuring data.  Is is used primarily to transmit data between a server and web application.   

XML, HTML, and Text are other formats. 

A type of software architecture, in which clients send requests to servers, and servers return responses after processing requests. It is the most commonly used architecture for APIs. The MARS API uses REST architecture.