Property Search API
Implementation Guide
Introduction
Please see the Overview Page to review account setup, authentication instructions, and other common API features.
Searchbug® Property Records API delivers essential property details, including property owner name, buyer and seller history, address, size, assessed value, tax information, acreage, legal description, USPS classification, sales history, and much more. It also includes the sales history of the property, including title company and loan details, and a comparable report on each property.
Designed for professionals in real estate, lending, insurance, debt collection, legal, and more, this API provides reliable property data to streamline research and decision-making. For best results, please supply the Parcel ID of the property.
Are you curious about how to easily integrate this API into your existing systems? This API Documentation is here to guide you!
This guide includes:
- Sending Request
- Receiving Results
- Errors
Sending Request
The request should be sent to Searchbug using the following URL using the POST method:
https://data.searchbug.com/api/search.aspx
Search Parameters
You can submit your request via:
- POST Header: Parameters sent as custom headers
- POST Body: Parameters sent as form-data
| Parameter | Value Example | Description |
|---|---|---|
| CO_CODE | 12345678 | Required. Your account number |
| PASS | H4z865i3$1 | API Key or account password (not needed if using Bearer Token) |
| TYPE | api_prop | Required. Use api_prop for this API |
| SRCH | P | Determines the search type.
|
| WHAT | 10-700900 | This field holds the value for the data to be searched, and is used for passing Parcel ID, Owner
Name and Property Address.
Examples:
|
| LOCATION | Geauga County | This is a required field that could be a City, county, state or ZIP.
Examples:
|
| FORMAT | JSON | Optional. The default is XML. To get results in JSON format, pass FORMAT=JSON |
| REF | CUST001 | Optional. Used for API usage tracking per application or customer (100 char max). |
Receiving Results
The results are returned in the XML format. This is an example:
<RESULTS>
<STATUS>OK</STATUS>
<COUNT>1</COUNT>
<PAGE>1</PAGE>
<RPP>10</RPP>
<PROPERTY>
<PARCEL_ID>10-700900</PARCEL_ID> <COUNTY_ID>39055</COUNTY_ID>
<RAUSA_ID>41792</RAUSA_ID>
<COUNTY_NAME>GEAUGA</COUNTY_NAME>
<MUNI_NAME>CHARDON</MUNI_NAME>
<STATE_ABBR>OH</STATE_ABBR>
<ADDR_NUMBER>100</ADDR_NUMBER>
<ADDR_STREET_NAME>SHORT COURT</ADDR_STREET_NAME>
<ADDR_STREET_TYPE>ST</ADDR_STREET_TYPE>
<PHYSCITY>CHARDON</PHYSCITY>
<PHYSZIP>44024</PHYSZIP>
<CENSUS_ZIP>44024</CENSUS_ZIP>
<OWNER>GEAUGA COUNTY BOARD OF COMMISSIONERS</OWNER> <MAIL_NAME>GEAUGA COUNTY BOARD</MAIL_NAME> <MAIL_ADDRESS1>231 MAIN ST</MAIL_ADDRESS1> <MAIL_ADDRESS3>CHARDON OH 44024</MAIL_ADDRESS3>
<TRANS_DATE>1990-01-01</TRANS_DATE>
<SALE_PRICE>0.00</SALE_PRICE>
<MKT_VAL_LAND>65100.00</MKT_VAL_LAND>
<MKT_VAL_BLDG>1826600.00</MKT_VAL_BLDG>
<MKT_VAL_TOT>1891700.00</MKT_VAL_TOT>
<NGH_CODE>18000</NGH_CODE>
<LAND_USE_CODE>620</LAND_USE_CODE>
<LAND_USE_CLASS>TAX EXEMPT</LAND_USE_CLASS>
<MUNI_ID>2397604</MUNI_ID>
<SCHOOL_DIST_ID>3904718</SCHOOL_DIST_ID>
<ACREAGE>0.0000</ACREAGE>
<ACREAGE_CALC>0.16</ACREAGE_CALC>
<ACREAGE_ADJACENT_WITH_SAMEOWNER>0.595319567312862</ACREAGE_ADJACENT_WITH_SAMEOWNER>
<ELEVATION>1302.33615088755</ELEVATION>
<BUILDINGS>1</BUILDINGS>
<LEGAL_DESC1>COURTHOUSE BUILDING ONLY</LEGAL_DESC1>
<LEGAL_DESC2>COURTHOUSE BUILDING ONLY</LEGAL_DESC2>
<LEGAL_DESC3>COURTHOUSE BUILDING ONLY</LEGAL_DESC3>
<LAST_UPDATED>2023-Q1</LAST_UPDATED>
<MAIL_ADDRESSNUMBER>231</MAIL_ADDRESSNUMBER>
<MAIL_STREETNAME>MAIN</MAIL_STREETNAME>
<MAIL_STREETNAMEPOSTTYPE>ST</MAIL_STREETNAMEPOSTTYPE>
<MAIL_PLACENAME>CHARDON</MAIL_PLACENAME>
<MAIL_STATENAME>OH</MAIL_STATENAME>
<MAIL_ZIPCODE>44024</MAIL_ZIPCODE>
<LAND_COVER>
<COUNT_23>0.16</COUNT_23>
</LAND_COVER>
<CROP_COVER>
<COUNT_123>0.11</COUNT_123>
<COUNT_122>0.05</COUNT_122>
</CROP_COVER>
</PROPERTY>
</RESULTS>
Here is an example of JSON results:
{
"Status": "Success",
"Data": {
"STATUS": "OK",
"COUNT": "1",
"PAGE": "1",
"RPP": "10",
"PROPERTY": {
"PARCEL_ID": "10-700900",
"COUNTY_ID": "39055",
"RAUSA_ID": "41792",
"COUNTY_NAME": "GEAUGA", "MUNI_NAME": "CHARDON",
"STATE_ABBR": "OH",
"ADDR_NUMBER": "100",
"ADDR_STREET_NAME": "SHORT COURT", "ADDR_STREET_TYPE": "ST",
"PHYSCITY": "CHARDON",
"PHYSZIP": "44024",
"CENSUS_ZIP": "44024",
"OWNER": "GEAUGA COUNTY BOARD OF COMMISSIONERS",
"MAIL_NAME": "GEAUGA COUNTY BOARD",
"MAIL_ADDRESS1": "231 MAIN ST", "MAIL_ADDRESS3": "CHARDON OH 44024", "TRANS_DATE": "1990-01-01",
"SALE_PRICE": "0.00",
"MKT_VAL_LAND": "65100.00",
"MKT_VAL_BLDG": "1826600.00",
"MKT_VAL_TOT": "1891700.00",
"NGH_CODE": "18000",
"LAND_USE_CODE": "620",
"LAND_USE_CLASS": "TAX EXEMPT",
"MUNI_ID": "2397604",
"SCHOOL_DIST_ID": "3904718",
"ACREAGE": "0.0000",
"ACREAGE_CALC": "0.16",
"ACREAGE_ADJACENT_WITH_SAMEOWNER": "0.595319567312862",
"ELEVATION": "1302.33615088755",
"BUILDINGS": "1",
"LEGAL_DESC1": "COURTHOUSE BUILDING ONLY",
"LEGAL_DESC2": "COURTHOUSE BUILDING ONLY",
"LEGAL_DESC3": "COURTHOUSE BUILDING ONLY",
"LAST_UPDATED": "2023-01",
"MAIL_ADDRESSNUMBER": "231",
"MAIL_STREETNAME": "MAIN",
"MAIL_STREETNAMEPOSTTYPE": "ST",
"MAIL_PLACENAME": "CHARDON",
"MAIL_STATENAME":"OH",
"MAIL ZIPCODE": "44024",
"LAND_COVER": {
"COUNT_23": "0.16"
},
"CROP_COVER": {
"COUNT_123": "0.11",
"COUNT_122": "0.05"
}
}
},
"Error": null
}
Errors
Example of No Results
<?xml version="1.0" encoding="ISO-8859-1" standalone="true"?>
<ROOT>
<STATUS>OK</STATUS>
<COUNT>0</COUNT>
<PAGE>1</PAGE>
<RPP>10</RPP>
<QUERY>client=6QeHJ6vdKT&parcel_id=233814724®ion=cuyahoga&v=8<QUERY>
</ROOT>
Error Example - No "WHAT" parameter defined
<?xml version="1.0" encoding="ISO-8859-1" standalone="true"?>
<RESULTS>
<ERROR>PLEASE PROVIDE EITHER PARCEL ID, PROPERTY ADDRESS OR PROPERTY OWNER NAME.
</RESULTS>
For further technical details and customer support, please chat with us, email us, or call us (800) 990-2939.
For sales and pricing information please contact sales@searchbug.com.
