{
  "opencollection": "1.0.0",
  "info": {
    "name": "USDA NASS QuickStats Parameters Statistics API",
    "version": "v1"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "key",
      "value": "{{key}}",
      "placement": "query"
    }
  },
  "items": [
    {
      "info": {
        "name": "Statistics",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "USDA NASS Get Statistics",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://quickstats.nass.usda.gov/api/api_GET",
            "params": [
              {
                "name": "key",
                "value": "",
                "type": "query",
                "description": "API key obtained by registering at the QuickStats API portal."
              },
              {
                "name": "commodity_desc",
                "value": "",
                "type": "query",
                "description": "Commodity description (e.g., CORN, SOYBEANS, CATTLE)."
              },
              {
                "name": "class_desc",
                "value": "",
                "type": "query",
                "description": "Commodity class description."
              },
              {
                "name": "statisticcat_desc",
                "value": "",
                "type": "query",
                "description": "Statistical category (e.g., AREA HARVESTED, PRODUCTION, PRICE RECEIVED)."
              },
              {
                "name": "unit_desc",
                "value": "",
                "type": "query",
                "description": "Unit of measurement (e.g., ACRES, BU, HEAD)."
              },
              {
                "name": "sector_desc",
                "value": "",
                "type": "query",
                "description": "Sector or division of the agricultural economy."
              },
              {
                "name": "group_desc",
                "value": "",
                "type": "query",
                "description": "Commodity group description (e.g., FIELD CROPS, VEGETABLES)."
              },
              {
                "name": "state_alpha",
                "value": "",
                "type": "query",
                "description": "Two-letter state abbreviation (e.g., VA, IA, TX)."
              },
              {
                "name": "state_name",
                "value": "",
                "type": "query",
                "description": "Full state name."
              },
              {
                "name": "county_name",
                "value": "",
                "type": "query",
                "description": "County name."
              },
              {
                "name": "agg_level_desc",
                "value": "",
                "type": "query",
                "description": "Geographic aggregation level (NATIONAL, STATE, COUNTY, ZIP CODE)."
              },
              {
                "name": "year",
                "value": "",
                "type": "query",
                "description": "Survey year (e.g., 2023). Supports operators like year__GE=2010."
              },
              {
                "name": "year__GE",
                "value": "",
                "type": "query",
                "description": "Year greater than or equal to specified value."
              },
              {
                "name": "year__LE",
                "value": "",
                "type": "query",
                "description": "Year less than or equal to specified value."
              },
              {
                "name": "freq_desc",
                "value": "",
                "type": "query",
                "description": "Data collection frequency (ANNUAL, MONTHLY, WEEKLY, POINT IN TIME, SEASONAL)."
              },
              {
                "name": "reference_period_desc",
                "value": "",
                "type": "query",
                "description": "Reference period description (e.g., YEAR, JAN, JUN)."
              },
              {
                "name": "format",
                "value": "",
                "type": "query",
                "description": "Response format (JSON, XML, CSV). Defaults to JSON."
              },
              {
                "name": "callback",
                "value": "",
                "type": "query",
                "description": "JSONP callback function name for cross-origin requests."
              }
            ]
          },
          "docs": "Retrieves agricultural statistics data records from the Quick Stats database. Supports filtering by commodity, location, time period, and statistical category using comparison operators. Returns up to 50,000 records per request. Response formats include JSON (default), XML, and CSV."
        },
        {
          "info": {
            "name": "USDA NASS Get Record Counts",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://quickstats.nass.usda.gov/api/get_counts",
            "params": [
              {
                "name": "key",
                "value": "",
                "type": "query",
                "description": "API key."
              },
              {
                "name": "commodity_desc",
                "value": "",
                "type": "query",
                "description": "Commodity description to count records for."
              },
              {
                "name": "state_alpha",
                "value": "",
                "type": "query",
                "description": "State abbreviation to filter."
              },
              {
                "name": "year__GE",
                "value": "",
                "type": "query",
                "description": "Year filter (greater than or equal)."
              }
            ]
          },
          "docs": "Returns the total count of records that would be returned by a given query without fetching the actual data. Useful for validating queries before making full data requests, particularly to ensure results stay within the 50,000 record limit."
        }
      ]
    }
  ],
  "bundled": true
}