Agricultural Statistics Service · Schema

Statistics Record

A single agricultural statistics data record from the QuickStats database.

AgricultureFederal GovernmentStatisticsOpen DataGeospatial

Properties

Name	Type	Description
source_desc	string	Data source type (SURVEY or CENSUS).
sector_desc	string	High-level sector of the agricultural economy.
group_desc	string	Commodity group within the sector.
commodity_desc	string	Name of the agricultural commodity.
class_desc	string	Commodity class or subtype.
statisticcat_desc	string	Statistical measurement category.
unit_desc	string	Unit of measurement for the value.
short_desc	string	Short description combining commodity and statistic.
domain_desc	string	Domain category (TOTAL, CHEMICAL, IRRIGATION, etc.).
agg_level_desc	string	Geographic aggregation level.
state_alpha	string	Two-letter state abbreviation.
state_name	string	Full state name.
county_name	string	County name (if county-level data).
year	integer	Survey or census year.
freq_desc	string	Data collection frequency.
reference_period_desc	string	Reference time period (YEAR, JAN, JUN, etc.).
value	string	Statistical value (may include formatting like commas; use as string).
CV_pct	string	Coefficient of variation percentage (data reliability indicator).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/agricultural-statistics-service/refs/heads/main/json-schema/quickstats-api-statistics-record-schema.json",
  "title": "Statistics Record",
  "description": "A single agricultural statistics data record from the QuickStats database.",
  "type": "object",
  "properties": {
    "source_desc": {
      "type": "string",
      "description": "Data source type (SURVEY or CENSUS).",
      "example": "SURVEY"
    },
    "sector_desc": {
      "type": "string",
      "description": "High-level sector of the agricultural economy.",
      "example": "CROPS"
    },
    "group_desc": {
      "type": "string",
      "description": "Commodity group within the sector.",
      "example": "FIELD CROPS"
    },
    "commodity_desc": {
      "type": "string",
      "description": "Name of the agricultural commodity.",
      "example": "CORN"
    },
    "class_desc": {
      "type": "string",
      "description": "Commodity class or subtype.",
      "example": "ALL CLASSES"
    },
    "statisticcat_desc": {
      "type": "string",
      "description": "Statistical measurement category.",
      "example": "AREA HARVESTED"
    },
    "unit_desc": {
      "type": "string",
      "description": "Unit of measurement for the value.",
      "example": "ACRES"
    },
    "short_desc": {
      "type": "string",
      "description": "Short description combining commodity and statistic.",
      "example": "CORN - ACRES HARVESTED"
    },
    "domain_desc": {
      "type": "string",
      "description": "Domain category (TOTAL, CHEMICAL, IRRIGATION, etc.).",
      "example": "TOTAL"
    },
    "agg_level_desc": {
      "type": "string",
      "description": "Geographic aggregation level.",
      "example": "STATE"
    },
    "state_alpha": {
      "type": "string",
      "description": "Two-letter state abbreviation.",
      "example": "VA"
    },
    "state_name": {
      "type": "string",
      "description": "Full state name.",
      "example": "VIRGINIA"
    },
    "county_name": {
      "type": "string",
      "description": "County name (if county-level data).",
      "example": "FAIRFAX"
    },
    "year": {
      "type": "integer",
      "description": "Survey or census year.",
      "example": 2023
    },
    "freq_desc": {
      "type": "string",
      "description": "Data collection frequency.",
      "example": "ANNUAL"
    },
    "reference_period_desc": {
      "type": "string",
      "description": "Reference time period (YEAR, JAN, JUN, etc.).",
      "example": "YEAR"
    },
    "value": {
      "type": "string",
      "description": "Statistical value (may include formatting like commas; use as string).",
      "example": "400,000"
    },
    "CV_pct": {
      "type": "string",
      "description": "Coefficient of variation percentage (data reliability indicator).",
      "example": ""
    }
  }
}