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.