Skip to main content
GET
List Commodities

Authorizations

Authorization
string
header
required

Your API key, which starts with orbbit_data_.

Query Parameters

category
string

The food group: dairy, poultry, meat, grains, fruits or vegetables. Leave it out to list every group.

commodity
string

The product being priced, as one exact word, such as corn, beef, cheese or shell_eggs. Leave it out to list every product.

attributes
object

Details that set a product apart, such as the cut of meat or the size. Send each one in brackets, such as attributes[meat_cut]=breasts&attributes[size_class]=large. Only series matching every detail you send are listed.

Example:
region
string

Where the price applies, such as us, us_southwest or us_mississippi.

market_level
string

The step in the supply chain where the price is paid: farm, wholesale or retail.

freight
string

USDA's shipping term: fob (at the seller's location), delivered or not_stated.

frequency
string

How often USDA publishes the series: daily, weekly, biweekly, monthly or annual.

price_type
string

Which number the series is: low, high, avg, mostly_low, mostly_high, close or value.

unit
string

What each value is in, such as usd_per_lb, usd_per_dozen or usd_per_package.

measure
string

USDA's own name for the number, such as wtd_avg_price.

limit
integer

How many series to return per page, from 1 to 500. The default is 100.

cursor
string

To get the next page, pass the next_cursor from the previous reply. Leave it out for the first page.

Response

data
object[]
required

The series on this page.

next_cursor
string | null
required

Pass as cursor to get the next page. null on the last page.