# info.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. 

# paths./.get.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. 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.

Please note, the API request format has been edited from POST to GET. Changes will be reflected in the Documentation and Jupyter Notebook.

Farmland Sales Example Response

Documentation

Notebook

Github Repo

Click the Jupyter Notebook Static Sample to view a static rendition of this APIs Jupyter Notebook.
Click the Jupyter Notebook Github Repo to access the Jupyter Notebook .ipynb files and
instructions needed in order to run this APIs Jupyter Notebook.

Header Parameters ▼

Header Parameters

content-type: "application/json”

Ocp-Apim-Subscription-Key: Subscription keys are given upon purchase

Request Parameters ▼

Request Parameters

Parameter

Data Type

Required?

Options

Description

State

Text

Yes

Illinois, Indiana, Iowa, Kansas, Michigan, Minnesota, Missouri, Nebraska, North Dakota, Ohio, South Dakota, Wisconsin

State of interest. Title cased. Ex. "Michigan" or "Ohio"

County

Text

No

Counties in the above states

County of interest. Title cased. Ex. "Osceola" or "Polk" Note: This parameter will be valid only if the State parameter is provided

Bounding_box

Text

Yes

GeoJSON

Area of interest in GeoJSON format. Note: Please provide at least one parameter selected from 'State', 'County', and 'Bounding_box'

Status

Text

Conditional

'Sold', 'For Sale', 'Expired Listing'

Sale condition of the property

StartDate

Integer

Conditional

'yyyy-mm-dd'

Searching starting date of the property Sale Date. In format 'yyyy-mm-dd' Note: Required only if Status is 'Sold'

EndDate

Integer

Yes

'yyyy-mm-dd'

Searching starting date of the property Sale Date. In format 'yyyy-mm-dd' Note: Required only if Status is 'Sold'

Response Parameters ▼

Response Parameters

Parameter

Type

Description

status

String

Status of the API call. ("SUCCESS", "FAILURE", "WARNING")

msg

Text

---

Listing Parameter

Type

Description

Listing_id

String

The unique ID for each listing(sales).

Entry_Updated

Date

The date of the listing(sales) information has been updated

Avg_CSR2

Integer

The average The Iowa Corn Suitability Rating(Soil Productivity Index)

CRP

String

If the property joined the Conservation Reserve Program.(‘Yes’ or 'No')

CRP_Acres

Float

The CRP acres

Total_Acres

Float

The total acres of the entire sale

Tillable_Acres

Float

The tillable acres of the sale

Percent_Tillable

Float

The percent tillable area

Sale_Price

Float

The total sale price of the sale record

Price_Acre

Float

The price per acre of the sale record

Status

String

One of the following values: "For Sale", "Listing Expired", "Sold"

Sale_Condition

String

One of the following values: "Auction", "Listing"

Listing_Agent

String

The listing agent name

Broker_URL

String

The URL link to the broker listing webpage as a string

Buyer

String

The buyer name as a string

Sale_Date

String

The sale date string in YYYY-MM-DD format. (When the parcel is still listing, the attribute will be Null)

Taxes_total

Float

Taxes for the sale as a float

Assessed_Land

String

If the land/parcel has been assessed

Parcel Parameter

Type

Description

Parcel_ID

String

The unique sale ID for each parcel as a string

Parcel

String

Index of the parcel in one listing(transaction)

Shape

String

The boundary of the parcel/property in Well Known Text type

GeoJSON

String

The boundary of the parcel/property in GeoJSON type

Acres

Float

Area of the parcel

State

String

The state where the parcel/property locates in

County

String

The county where the parcel/property locates in

lat_center

Float

The latitudinal center of the parcel/property as a float value

lng_center

Float

The longitudinal center of the parcel/property as a float value

range

String

The range as a string (ex: 26W - always include E or W)

sect

String

The section as string (ex: 17)

twnshp

String

The township as a string (ex: 78N - always include N or S)

county_name

String

The county name as a string (Title cased - for ex: Osceola, Polk, etc.)

state_name

String

The state name as a string (Title cased - for ex: Michigan)

STATEFP

String

The FIPS to state level as a string

FIPS

String

The FIPS to county level as a string

# paths./.get.parameters[].description
State of interest, title cased. Ex. "Michigan"

# paths./.get.parameters[].description
County of interest, title cased. Ex. "Osceola"