Agricultural Statistics Service · JSON Structure

Quickstats Api Statistics Record Structure

A single agricultural statistics data record from the QuickStats database.

Type: object Properties: 18

AgricultureFederal GovernmentStatisticsOpen DataGeospatial

Statistics Record is a JSON Structure definition published by Agricultural Statistics Service, describing 18 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

source_desc sector_desc group_desc commodity_desc class_desc statisticcat_desc unit_desc short_desc domain_desc agg_level_desc state_alpha state_name county_name year freq_desc reference_period_desc value CV_pct

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/agricultural-statistics-service/refs/heads/main/json-structure/quickstats-api-statistics-record-structure.json",
  "name": "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": "int32",
      "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": ""
    }
  }
}