List Commodity Products
curl --request GET \
--url https://data.orbbit.co/v1/commodities \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.orbbit.co/v1/commodities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://data.orbbit.co/v1/commodities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"slug": "cheese_block_cheddar_40_lb",
"category": "food_beverages_tobacco/food_items/dairy_products/cheese",
"attributes": {
"cheese_form": "block"
},
"details": {
"size": "40 lb",
"cheese_style": "cheddar"
},
"metrics": [
{
"metric_name": "cheese_block_cheddar_40_lb_us_chicago_wholesale_daily_close_price_usd_per_lb",
"measure": "close_price",
"unit": "usd_per_lb",
"region": "us_chicago",
"market_level": "wholesale",
"freight": "not_stated",
"frequency": "daily",
"source": "usda-mars",
"first_observed_on": "2021-02-24",
"last_observed_on": "2026-08-21"
},
{
"metric_name": "cheese_block_cheddar_40_lb_us_wholesale_weekly_cheese_40_price_usd_per_lb",
"measure": "cheese_40_price",
"unit": "usd_per_lb",
"region": "us",
"market_level": "wholesale",
"freight": "not_stated",
"frequency": "weekly",
"source": "usda-mpr",
"first_observed_on": "2012-03-03",
"last_observed_on": "2026-08-15"
}
]
}
],
"next_cursor": "cheese_block_cheddar_40_lb"
}{
"error": {
"type": "invalid_request",
"message": "limit: Too big: expected number to be <=500"
}
}{
"error": {
"type": "unauthorized",
"message": "Missing or malformed Authorization: Bearer header"
}
}{
"error": {
"type": "insufficient_balance",
"message": "Insufficient balance"
}
}{
"error": {
"type": "forbidden",
"message": "This key is not scoped to search-commodities"
}
}Commodities
List Commodity Products
List priced products under a Shopify category route, each with every metric USDA publishes for it.
Requires the search-commodities scope.
GET
/
v1
/
commodities
List Commodity Products
curl --request GET \
--url https://data.orbbit.co/v1/commodities \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.orbbit.co/v1/commodities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://data.orbbit.co/v1/commodities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"slug": "cheese_block_cheddar_40_lb",
"category": "food_beverages_tobacco/food_items/dairy_products/cheese",
"attributes": {
"cheese_form": "block"
},
"details": {
"size": "40 lb",
"cheese_style": "cheddar"
},
"metrics": [
{
"metric_name": "cheese_block_cheddar_40_lb_us_chicago_wholesale_daily_close_price_usd_per_lb",
"measure": "close_price",
"unit": "usd_per_lb",
"region": "us_chicago",
"market_level": "wholesale",
"freight": "not_stated",
"frequency": "daily",
"source": "usda-mars",
"first_observed_on": "2021-02-24",
"last_observed_on": "2026-08-21"
},
{
"metric_name": "cheese_block_cheddar_40_lb_us_wholesale_weekly_cheese_40_price_usd_per_lb",
"measure": "cheese_40_price",
"unit": "usd_per_lb",
"region": "us",
"market_level": "wholesale",
"freight": "not_stated",
"frequency": "weekly",
"source": "usda-mpr",
"first_observed_on": "2012-03-03",
"last_observed_on": "2026-08-15"
}
]
}
],
"next_cursor": "cheese_block_cheddar_40_lb"
}{
"error": {
"type": "invalid_request",
"message": "limit: Too big: expected number to be <=500"
}
}{
"error": {
"type": "unauthorized",
"message": "Missing or malformed Authorization: Bearer header"
}
}{
"error": {
"type": "insufficient_balance",
"message": "Insufficient balance"
}
}{
"error": {
"type": "forbidden",
"message": "This key is not scoped to search-commodities"
}
}Authorizations
Your API key, which starts with orbbit_data_.
Query Parameters
A Shopify category route or the start of one, e.g. food_beverages_tobacco/food_items/dairy_products; absent lists every product
Products per page, 1–500; default 100
The next_cursor of the previous page