Using ATTOM API

ATTOM API

ATTOM has developed a REST API that sits on top of ATTOM Cloud, providing an alternative way of accessing its comprehensive portfolio of property data.

Endpoint Naming Standards

For a complete list of API endpoints available via ATTOM API, please consult our online API Developer Guide.

ATTOM API Endpoints

Because ATTOM API has now been built on top of ATTOM Cloud, all new ATTOM API endpoints will follow a new naming standard consistent with the taxonomy used for ATTOM Cloud data.

Example:

https://api.gateway.attomdata.com/v4/neighborhood/community

1. https://api.gateway.attomdata.com - base URL used to access all ATTOM API endpoints
2. v4 - version number for the endpoint used to provide backward compatibility each time an endpoint is extended or enhanced.
3. neighborhood - One of seven data families to which the endpoint belongs (boundary, hazard, listing, neighborhood, property, transaction, valuation)
4. community - Data element to which the endpoint belongs

Legacy Endpoints

ATTOM has developed and acquired a number of REST endpoints that don't fully comply with the above naming standards. These existing endpoints will continue to be supported by ATTOM to ensure existing programs continue to operate without change.

Example: 

https://api.gateway.attomdata.com/propertyapi/v1.0.0/property/id

1. https://api.gateway.attomdata.com - the same base URL used to access all ATTOM API endpoints
2. propertyapi - Original APIs were broken into four APIs - propertyapi, areaapi, poisearch, communityapi
3. v1.0.0 - version number for the endpoint used to provide backward compatibility each time an endpoint is extended or enhanced
4. property/id - Name of the endpoint

Authentication

Calls to the ATTOM API will only return results if a valid token has been passed in the header of the request as a header parameter  apikey. Each ATTOM Cloud account provides a token that can be used for 30 days to evaluate the API. Details for the token are provided in the Direct Integration section of your ATTOM Cloud account.

The example below shows the use of Postman to test the ATTOM API, with the security token above added to the header as apikey

Contact sales (800) 659-2877 if you need to extend your trial key, or need information about pricing.

Query String Parameters

Being a REST API, query string parameters can be provided to direct the endpoint as to what data it should be returned.

https://api.gateway.attomdata.com/propertyapi/v1.0.0/property/id?geoid=PL0820000&minBeds=1&maxBeds=2

For a full list of the parameters used by each endpoint please consult our online API Developer Guide.

Data Dictionary

The range of property data offered via ATTOM Cloud and the ATTOM API is comprehensive. To identify which endpoints can be used to access specific property data we suggest making use of the Data Dictionary included as part of our online API Developer Guide.