United States Department of Agriculture · Example Payload

Usda Nass Get Statistics Example

Federal GovernmentAgricultureFood SafetyNutritionRural DevelopmentClimate

Usda Nass Get Statistics Example is an example object payload from United States Department of Agriculture, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

operationIdrequestresponse

Example Payload

{
  "operationId": "getAgriculturalStatistics",
  "request": {
    "method": "GET",
    "url": "https://quickstats.nass.usda.gov/api/api_GET/",
    "parameters": {
      "key": "YOUR_API_KEY",
      "commodity_desc": "CORN",
      "statisticcat_desc": "PRODUCTION",
      "year": "2023",
      "agg_level_desc": "STATE",
      "format": "JSON"
    }
  },
  "response": {
    "status": 200,
    "contentType": "application/json",
    "body": {
      "data": [
        {
          "source_desc": "SURVEY",
          "sector_desc": "CROPS",
          "group_desc": "FIELD CROPS",
          "commodity_desc": "CORN",
          "class_desc": "ALL CLASSES",
          "prodn_practice_desc": "ALL PRODUCTION PRACTICES",
          "util_practice_desc": "GRAIN",
          "statisticcat_desc": "PRODUCTION",
          "unit_desc": "BU",
          "short_desc": "CORN, GRAIN - PRODUCTION, MEASURED IN BU",
          "domain_desc": "TOTAL",
          "agg_level_desc": "STATE",
          "state_alpha": "IA",
          "state_name": "IOWA",
          "year": 2023,
          "freq_desc": "ANNUAL",
          "reference_period_desc": "YEAR",
          "Value": "2,258,000,000",
          "CV (%)": "1.2"
        }
      ]
    }
  }
}