livestock_and_meat_domestic_data
Get ERS livestock and meat domestic data - slaughter, production, weights, cold storage, supply and disappearance, and livestock and wholesale prices, each pivoted to a wide layout by attribute.
Examples
from openbb import obb
obb.usda.livestock_and_meat_domestic_data(provider='usda')
# Get red meat and poultry production since 2020.
obb.usda.livestock_and_meat_domestic_data(table='production', start_year=2020, provider='usda')
# Get monthly livestock prices since 2024.
obb.usda.livestock_and_meat_domestic_data(table='livestock_prices', start_year=2024, provider='usda')
Parameters
- standard
- usda
table: str | None
Default: supply_and_disappearance
Description
Livestock and meat table to retrieve. Each table is a set of named slaughter, production, weight, cold-storage, supply-and-use, or price series indexed by year and period; the attributes become the wide value columns, prefixed by commodity or sub-table where that dimension splits the series. Valid tables are:
supply_and_disappearance, slaughter, production, live_and_dressed_weights, cold_storage, livestock_prices, wholesale_prices, feeder_cattle_outside_feedlots, heifers_entering_the_herd, high_plains_cattle_feeding_simulator
start_year: int | None
Start year for filtering the data, compared against the observation year. If None, returns from the beginning of the series.
end_year: int | None
End year for filtering the data, compared against the observation year. If None, returns up to the most recent year.
Returns
results: LivestockAndMeatDomesticData
Serializable results.
provider: str | None
Provider name.
warnings: Optional[list[Warning_]]
List of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- usda
period: str
Row label of the observation: the year for annual tables ('2020'), the year and month, quarter, or feeding window for sub-annual tables ('2020 January', '2020 Q1 Jan-Mar'), with any commodity, sub-table, or geography that is not carried in the column headers prefixed so each row is uniquely labeled.