Data dictionary

Every column, explained

This is the complete layout of a USA Ag Data CSV export — no hidden fields, no surprises. If a value can't be verified, it ships empty rather than guessed. See the methodology for how values are sourced and scored.

Identity & role

ColumnMeaning
idStable record identifier in our database.
farm_or_ranch_nameDisplay name of the farm, ranch, business, or person.
entity_kindWhat kind of entity this is (person, farm business, trust, etc.).
role_typePrimary role: landowner, operator, producer, farm business, absentee owner, parcel owner, ranch entity, or contact person.
rolesAll roles observed across sources, semicolon-separated.

Addresses

Mailing address is always present; physical and parcel addresses appear when sources provide them.

ColumnMeaning
address_line1 / address_line2 / city / state / zipMailing address.
physical_address_line1 / physical_city / physical_state / physical_zipPhysical location when it differs from mailing.
parcel_address_line1 / parcel_city / parcel_state / parcel_zipSitus address of a matched parcel.
county_name / county_fipsCounty of the record and its FIPS code.

Acreage

ColumnMeaning
acreage_totalTotal verified acres. Empty when acreage is not yet verified — we never guess.
acreage_parcel_countNumber of parcels behind the acreage figure.
acreage_proof_levelHow acreage was verified (e.g. parcel owner + situs address + deeded acre match, organic certification).
farm_size_classBucketed size: under_10 through 1000_plus.

Quality scores (0–100)

ColumnMeaning
confidence_scoreHow confident we are this record is a real, current ag operation.
fit_scoreHow well the record fits typical ag-prospect use.
contactability_scoreStrength of available contact channels.
freshness_scoreHow recently the record was seen in a source.
source_diversity_scoreHow many independent sources corroborate it.
conflict_risk_scoreRisk that sources disagree about this record.

Signals

ColumnMeaning
crop_signalsObserved crop evidence (corn, soybeans, wheat, …), semicolon-separated.
livestock_signalsObserved livestock evidence (cattle, dairy, poultry, …).
enrichment_signalsAdditional public evidence (storage bins, irrigation, organic, …).

Contact channels

Phone and SMS fields are never included — they stay gated until DNC/TCPA compliance review clears them.

ColumnMeaning
emailPublic business email, when available.
websiteBusiness website.
contact_form_urlPublic contact form.

Lineage & terms

ColumnMeaning
source_idsIdentifiers of every source that contributed to this record.
source_typesSource classes (fsa_payments, parcel_assessor, organic_certification, …).
last_seen_atMost recent time any source confirmed the record.
permitted_use_noticeThe acceptable-use terms embedded in every row.