| filtersbody | object | Farm criteria (the filters.* fields below). Omit for the whole dataset. Different fields are AND'd; values inside one field are OR'd. Limits: 5,000 values per list, 500 characters per value. |
| excludeFiltersbody | object | Same shape as filters; matching records are left out. A value listed in both is dropped from filters. When this holds any value, filterMode is ignored. |
| filterModebody | string | "include" (default) or "exclude": treat every value in filters as an exclusion instead. |
| countBybody | string | string[] | records (default: farm records), farmers (distinct producers), farmLands (distinct farm locations), ranchers (distinct producers with cattle, dairy, hogs, sheep, goats or horses), poultryFishBees (distinct producers with poultry, fish or bees). An array adds data.counts; data.count is the first one. |
| filters.statesbody | string[] | Full state names ("Iowa") or two-letter codes ("IA"), case-sensitive. District of Columbia is included. |
| filters.statesNarrowedbody | string[] | The selected states that your cities, counties, ZIP codes or radius narrow; the other selected states count whole. |
| filters.citiesbody | string[] | City ids from the Navigator's geography catalog (not names). /ai-criteria resolves city names to these ids. |
| filters.countiesbody | string[] | County ids from the Navigator's geography catalog (not names). /ai-criteria resolves county names to these ids. |
| filters.zipCodesbody | string[] | Five-digit ZIP codes (e.g. "50010"), or catalog ZIP ids. |
| filters.citiesOutsidebody | string[] | City ids in states you have not selected; added to the state selection instead of narrowing it. |
| filters.countiesOutsidebody | string[] | County ids in states you have not selected; added to the state selection instead of narrowing it. |
| filters.zipCodesOutsidebody | string[] | ZIP codes in states you have not selected; added to the state selection instead of narrowing it. |
| filters.radiusByZipbody | object | { minLat, maxLat, minLon, maxLon } bounding box (all four required), plus optional centerLat, centerLon and radiusMiles to match a true distance circle instead. |
| filters.cropsbody | string[] | Crop names from /meta crops or otherCrops (e.g. "Corn", "Soybean", "Apple"). Unknown names are ignored. |
| filters.livestockbody | string[] | Cattle, Dairy, Hogs, Sheep, Goats, Horses, Poultry, Fish, Bees. |
| filters.cattleOutputTypesbody | string[] | Cattle categories from /meta cattleOutputTypes (e.g. "Steers", "Bulls"). When set, these replace a plain Cattle pick. |
| filters.grassTypesbody | string[] | Grass/turf uses from /meta grassTypes (e.g. "Grazing", "Turf Sod"). |
| filters.acreRangesbody | string[] | Total-acre buckets: 1-9, 10-24, 25-49, 50-99, 100-249, 250-499, 500-999, 1000-2499, 2500-4999, 5000+. |
| filters.exactAcreRangesbody | string[] | "min-max" total acres, e.g. "300-800". |
| filters.exactAcreComparisonsbody | string[] | "op:value" total acres, op = more (at least), less or equal, e.g. "more:500". |
| filters.primaryAcreFiltersbody | object | Acres of one crop: { "Corn Acre": ["100 to 249"] }. Keys from /meta primaryAcreCrops, ranges from /meta acreBucketRangeOptions. |
| filters.secondaryAcreFiltersbody | object | Same shape for the other-crops list: { "Apple Acre": ["1 to 9"] }. Keys from /meta secondaryAcreCrops. |
| filters.livestockHeadRangesbody | string[] | Total head-count buckets from /meta livestockHeadRangeOptions ("1 - 10" to "5000+", or "Unknown"). |
| filters.livestockHeadFiltersbody | object | Head count per animal: { "Cattle": ["501 - 1000"] }. Keys: Total, Cattle, Dairy, Goat, Hog, Sheep. |
| filters.producerTypesbody | string[] | Producer types from /meta producerTypes (e.g. "Owner / Operator Producer Type"). |
| filters.entityCodeTypesbody | string[] | Entity-type letters A to K; /meta entityCodeLabels names them (A = Individual, D = Corporation With Stockholders, ...). |
| filters.farmCountRangesbody | string[] | Number of farms the producer runs: 1-9, 10-19, 20-39, 40-99, 100-199, 200-299, 300-499, 500+. |
| filters.ageRangesbody | string[] | Producer age: 19-24, 25-34, 35-44, 45-54, 55-64, 65-74, 75+, Unknown. |
| filters.farmersTypebody | string | One of "Crop Farmers Only", "All Crop Farmers", "Livestock Farmers Only", "All Livestock Farmers". "Only" means that type and not the other. |
| filters.irrigatebody | string | "Yes" or "No". |
| filters.qualityFiltersbody | string[] | Data-quality requirements from /meta qualityFilters (e.g. "100% Phone", "Verified Email", "Omit PO Boxes"). Every one picked must hold. |
| filters.revenueRangesbody | string[] | Estimated revenue bands from /meta revenueRanges (e.g. "$100,001 - $200,000"). |
| filters.exactRevenueRangesbody | string[] | "min-max" estimated revenue in dollars, e.g. "1000000-5000000". |
| filters.revenueComparisonsbody | string[] | "op:value" estimated revenue in dollars, op = more (at least), less or equal, e.g. "more:500000". |