openapi: 3.0.1 info: title: Farmland Sales and Listings description: 'Ag-Analytics® Farmland Sales API provides users with easy and fast access to filter and find land for sale, complete with the sales and geographic data components to get a detailed description of that land’s value. ' version: '1.0' servers: - url: https://ag-analytics.azure-api.net/farmland-sales paths: /: get: summary: Farmland Sales - GET description: "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nAg-Analytics® Farmland Sales API provides users with easy and fast access to filter and find land for sale, complete with the sales and geographic data components to get a detailed description of that land’s value. The data of this service is originally provided by Farmland Finder. Each response item has a full description of the entire sale/listing information. Multiple parcel/land records can belong to one single listing. In the ‘parcels’ parameter in listing, each parcel record gives the detailed description of a certain land/parcel itself.\n\n\n\n
content-type: \"application/json”
\nOcp-Apim-Subscription-Key: Subscription keys are given upon purchase
\nParameter | \nData Type | \nRequired? | \nOptions | \nDescription | \n
---|---|---|---|---|
State | \nText | \nYes | \nIllinois, Indiana, Iowa, Kansas, Michigan, Minnesota, Missouri, Nebraska, North Dakota, Ohio, South Dakota, Wisconsin | \nState of interest. Title cased. Ex. \"Michigan\" or \"Ohio\" | \n
County | \nText | \nNo | \nCounties in the above states | \nCounty of interest. Title cased. Ex. \"Osceola\" or \"Polk\" Note: This parameter will be valid only if the State parameter is provided | \n
Bounding_box | \nText | \nYes | \nGeoJSON | \nArea of interest in GeoJSON format. Note: Please provide at least one parameter selected from 'State', 'County', and 'Bounding_box' | \n
Status | \nText | \nConditional | \n'Sold', 'For Sale', 'Expired Listing' | \nSale condition of the property | \n
StartDate | \nInteger | \nConditional | \n'yyyy-mm-dd' | \nSearching starting date of the property Sale Date. In format 'yyyy-mm-dd' Note: Required only if Status is 'Sold' | \n
EndDate | \nInteger | \nYes | \n'yyyy-mm-dd' | \nSearching starting date of the property Sale Date. In format 'yyyy-mm-dd' Note: Required only if Status is 'Sold' | \n
Parameter | \nType | \nDescription | \n
---|---|---|
status | \nString | \nStatus of the API call. (\"SUCCESS\", \"FAILURE\", \"WARNING\") | \n
msg | \nText | \n--- | \n
Listing Parameter | \nType | \nDescription | \n
Listing_id | \nString | \nThe unique ID for each listing(sales). | \n
Entry_Updated | \nDate | \nThe date of the listing(sales) information has been updated | \n
Avg_CSR2 | \nInteger | \nThe average The Iowa Corn Suitability Rating(Soil Productivity Index) | \n
CRP | \nString | \nIf the property joined the Conservation Reserve Program.(‘Yes’ or 'No') | \n
CRP_Acres | \nFloat | \nThe CRP acres | \n
Total_Acres | \nFloat | \nThe total acres of the entire sale | \n
Tillable_Acres | \nFloat | \nThe tillable acres of the sale | \n
Percent_Tillable | \nFloat | \nThe percent tillable area | \n
Sale_Price | \nFloat | \nThe total sale price of the sale record | \n
Price_Acre | \nFloat | \nThe price per acre of the sale record | \n
Status | \nString | \nOne of the following values: \"For Sale\", \"Listing Expired\", \"Sold\" | \n
Sale_Condition | \nString | \nOne of the following values: \"Auction\", \"Listing\" | \n
Listing_Agent | \nString | \nThe listing agent name | \n
Broker_URL | \nString | \nThe URL link to the broker listing webpage as a string | \n
Buyer | \nString | \nThe buyer name as a string | \n
Sale_Date | \nString | \nThe sale date string in YYYY-MM-DD format. (When the parcel is still listing, the attribute will be Null) | \n
Taxes_total | \nFloat | \nTaxes for the sale as a float | \n
Assessed_Land | \nString | \nIf the land/parcel has been assessed | \n
Parcel Parameter | \nType | \nDescription | \n
Parcel_ID | \nString | \nThe unique sale ID for each parcel as a string | \n
Parcel | \nString | \nIndex of the parcel in one listing(transaction) | \n
Shape | \nString | \nThe boundary of the parcel/property in Well Known Text type | \n
GeoJSON | \nString | \nThe boundary of the parcel/property in GeoJSON type | \n
Acres | \nFloat | \nArea of the parcel | \n
State | \nString | \nThe state where the parcel/property locates in | \n
County | \nString | \nThe county where the parcel/property locates in | \n
lat_center | \nFloat | \nThe latitudinal center of the parcel/property as a float value | \n
lng_center | \nFloat | \nThe longitudinal center of the parcel/property as a float value | \n
range | \nString | \nThe range as a string (ex: 26W - always include E or W) | \n
sect | \nString | \nThe section as string (ex: 17) | \n
twnshp | \nString | \nThe township as a string (ex: 78N - always include N or S) | \n
county_name | \nString | \nThe county name as a string (Title cased - for ex: Osceola, Polk, etc.) | \n
state_name | \nString | \nThe state name as a string (Title cased - for ex: Michigan) | \n
STATEFP | \nString | \nThe FIPS to state level as a string | \n
FIPS | \nString | \nThe FIPS to county level as a string | \n