farm_household_income_and_characteristics
Get ERS Farm Household Income and Characteristics - income, finances, and characteristics of U.S. farm operator households, each pivoted to a wide layout by year or category.
Examples
from openbb import obb
obb.usda.farm_household_income_and_characteristics(provider='usda')
# Get mean and median U.S. farm operator household income since 2000.
obb.usda.farm_household_income_and_characteristics(table='mean_median_income', start_year=2000, provider='usda')
# Get 2024 household characteristics by age of the principal operator.
obb.usda.farm_household_income_and_characteristics(table='by_age_2024', provider='usda')
Parameters
- standard
- usda
table: str | None
Default: finances_2021_26f
Description
Table to retrieve. Each table is a set of line items pivoted to a wide layout: the item stays as the pinned row column while the time-series tables spread years into value columns and the cross-tab tables spread a category into value columns. Valid tables are:
finances_2021_26f, mean_median_income, farm_size_class, by_farm_type_2024, by_occupation_2024, by_age_2024, by_experience_2024, by_management_team_2024, by_limited_resource_2024, by_sex_2024
start_year: int | None
Start year for filtering the data. Applies only to the time-series tables (farm_size_class, finances_2021_26f, mean_median_income). If None, returns from the first published year.
end_year: int | None
End year for filtering the data. Applies only to the time-series tables. If None, returns up to the most recent year or forecast year.
Returns
results: FarmHouseholdIncomeAndCharacteristics
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
item: str
Published line item of the selected table.