GEOAMCAN API / DATASET

USDA Census of Agriculture API

Aggregate farms, crops, livestock, producers, land use, sales, expenses and assets from the original Census bulk publication. Preserve overlapping domains, units, geography codes, reference periods, confidentiality and CV reliability symbols. These are statistical cells, not farm addresses or ownership/field boundaries. Explore coverage, source context and a verified API example.

Geography2022 published national, state, county and other native reporting areas
Release2022 Census of Agriculture original bulk edition
Available records6,077,214

What you can build

Aggregate farms, crops, livestock, producers, land use, sales, expenses and assets from the original Census bulk publication. Preserve overlapping domains, units, geography codes, reference periods, confidentiality and CV reliability symbols. These are statistical cells, not farm addresses or ownership/field boundaries. Use this dataset as a sourced input to an application, analytical model or retrieval tool. Retain its native dimensions when joining it with your own records.

Query USDA Census of Agriculture

The example below is a real bounded request against the available release. Replace the environment variable with your server-side API credential. Review endpoint parameters and response schemas before changing selectors.

Verified API request
curl --fail --get "https://api.geoamcan.com/v1/agriculture/census?geo_level=NATIONAL&commodity=FARM+OPERATIONS&domain=TOTAL&q=NUMBER+OF+OPERATIONS&unit=OPERATIONS&limit=1&dimension_filters=%7B%22SHORT_DESC%22%3A+%22FARM+OPERATIONS+-+NUMBER+OF+OPERATIONS%22%2C+%22CLASS_DESC%22%3A+%22ALL+CLASSES%22%7D" \
  -H "Authorization: Bearer $GEOAMCAN_API_KEY"

Saved response excerpt

{
  "requested_area": {
    "state": null,
    "county": null,
    "geo_level": "NATIONAL",
    "commodity": "FARM OPERATIONS",
    "q": "NUMBER OF OPERATIONS",
    "domain": "TOTAL",
    "domain_category": null,
    "unit": "OPERATIONS",
    "source_row": null,
    "metric_id": null,
    "dimension_filters": "{\"SHORT_DESC\": \"FARM OPERATIONS - NUMBER OF OPERATIONS\", \"CLASS_DESC\": \"ALL CLASSES\"}",
    "include_details": false
  },
  "data": [
    {
      "source_row": 815872,
      "metric_id": "9dc6ecd69ba8f194aa02f76448ee0c0fa999267390390626c52e5b541c1d3988",
      "year": "2022",
      "frequency": "ANNUAL",
      "reference_period": "YEAR",
      "begin_code": "00",
      "end_code": "00",
      "week_ending": "",
      "geo_level": "NATIONAL",
      "state_fips": null,
      "county_fips": null,
      "geography_name": "US TOTAL"
    }
  ],
  "availability": {
    "status": "available",
    "coverage": [
      {
        "records": 3339228,
        "geo_level": "COUNTY"
      }
    ],
    "symbol_definitions": {
      "(D)": "withheld_confidential",
      "(Z)": "less_than_half_displayed_unit",
      "(NA)": "not_available",
      "(X)": "not_applicable",
      "(L)": "below_0.05_percent_CV",
      "(H)": "at_least_99.95_percent_CV",
      "": "not_reported"
    }
  },
  "snapshot": {
    "usda-ag-census": {
      "release_id": 123,
      "release": "2022 Census of Agriculture original bulk edition",
      "fingerprint": "36d97004e40df5e9f430e8b8f3e22cdd"
    }
  },
  "returned_count": 1,
  "complete": true,
  "next_offset": null,
  "limitations": [
    "USDA 2022 Census of Agriculture aggregate statistical cells, not individual farm addresses or ownership records. Farms, producers, operations reporting a commodity, acres, livestock, sales, expenses, averages and ratios have different units and universes. Domain groups overlap; a farm can report several commodities. Do not sum overlapping cells or average published ratios. Preserve source production/utilization practices, domains, reference periods, dollar units and CV reliability indicators. (D) is confidential, (Z) is below half the displayed unit, (NA) is unavailable and (X) is not applicable; none is a known zero. CV (L) is below 0.05 percent and (H) is at least 99.95 percent. Blank/special native geography codes are not fabricated Census geographies. County geometry uses the installed Census boundary vintage and is not a farm or field boundary. This selected bulk release covers published 2022 Census cells only, not later annual survey estimates or all supplemental publications."
  ],
  "source_attribution": {
    "usda-ag-census": "USDA NASS 2022 Census of Agriculture original Quick Stats bulk publication. https://www.nass.usda.gov/publications/agcensus/2022"
  },
  "metric_definitions": {
    "value": {
      "meaning": "Native statistic in the exact source unit; no inferred scaling, cross-domain totals or conversion of suppressed/less-than-half-unit markers to zero"
    },
    "cv_percent": {
      "meaning": "Source coefficient of variation, percent; distinct from the estimate and not an ACS margin of error"
    },
    "source_row": {
      "meaning": "Row ordinal in the immutable source archive for this release; not a farm identifier"
    }
  }
}

Captured 2026-11-05. Excerpt omits pagination credentials and may shorten nested records. Download verified source responses.

Coverage and interpretation

USDA 2022 Census of Agriculture aggregate statistical cells, not individual farm addresses or ownership records. Farms, producers, operations reporting a commodity, acres, livestock, sales, expenses, averages and ratios have different units and universes. Domain groups overlap; a farm can report several commodities. Do not sum overlapping cells or average published ratios. Preserve source production/utilization practices, domains, reference periods, dollar units and CV reliability indicators. (D) is confidential, (Z) is below half the displayed unit, (NA) is unavailable and (X) is not applicable; none is a known zero. CV (L) is below 0.05 percent and (H) is at least 99.95 percent. Blank/special native geography codes are not fabricated Census geographies. County geometry uses the installed Census boundary vintage and is not a farm or field boundary. This selected bulk release covers published 2022 Census cells only, not later annual survey estimates or all supplemental publications.

The active release shown here is a catalog snapshot. Check the live catalog and response provenance for current readiness. The underlying public source and Geoamcan access terms are separate; consult the source’s licensing and attribution requirements.

Source and methodology

Source: USDA National Agricultural Statistics Service. Geoamcan is an independent API provider, with no agency affiliation or endorsement. Read our data methodology for source handling, geographic joins and update practices.

Related data

Put this data to work.

Tell us about your application, coverage needs and expected API usage.

Get API access ↗Read integration guides