Use this endpoint to retrieve lists of addresses.
Data Retriever
The Data Retriever Cloud API allows you to generate, download, and access lists of contacts, addresses, businesses, and more.
Data Retriever offers the following capabilities:
- Retrieve a count of results based on provided filters, including City/State, Radius, Zip code, and polygon Shape.
- Purchase a complete result set, navigate through the list of contacts and addresses using pagination.
Documentation
Useful Resources
Product Page
Support Center
Download OpenAPI description
Languages
Servers
Data Retriever Server
https://dataretriever.melissadata.net/web/V1/
Bodyapplication/jsonrequired
The License Key issued by Melissa.
Any parameter you would like to include in the query.
Requires at least one from:
- CensusKey
- Zips
- Cities
- Radius
- ShapeWKTs
A list of Zips objects containing Zip codes and optionally Plus4.
A Radius object containing a Latitude, Longitude, and Distance represented in miles.
A list of BaseMelissaAddressKeys.
A list of PreviousMelissaAddressKeys.
A list of PreviousBaseMelissaAddressKeys.
A list of EstimatedHouseholdIncomeCodes.
A list of EstimatedHousingValueCodes.
A list of PresenceOfChildrenCodes.
A list of DwellingSpecificCodes.
- Data Retriever Serverhttps://dataretriever.melissadata.net/web/V1/NewMovers/doCount
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X POST \
https://dataretriever.melissadata.net/web/V1/NewMovers/doCount \
-H 'Content-Type: application/json' \
-d '{
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Includes": {
"Zips": [
{
"Zip": "92688"
}
],
"MoveEffectiveDate": {
"StartDate": "2023/01/01",
"EndDate": "2024/01/01"
}
}
}'Response
application/json
{ "Count": 370, "JobId": "returned_job_id", "ResultCode": "LS01" }
Bodyapplication/jsonrequired
The License Key issued by Melissa.
Any parameter you would like to include in the query.
Requires at least one from:
- CensusKey
- Zips
- Cities
- Radius
- ShapeWKTs
A list of Zips objects containing Zip codes and optionally Plus4.
A Radius object containing a Latitude, Longitude, and Distance represented in miles.
A list of BaseMelissaAddressKeys.
A list of PreviousMelissaAddressKeys.
A list of PreviousBaseMelissaAddressKeys.
A list of EstimatedHouseholdIncomeCodes.
A list of EstimatedHousingValueCodes.
A list of PresenceOfChildrenCodes.
A list of DwellingSpecificCodes.
All NewMovers Columns you want returned.
Items Enum"MelissaAddressKey""BaseMelissaAddressKey""FullName""FirstName""MiddleName""LastName""AddressLine""City""State""ZIPCode"
- Data Retriever Serverhttps://dataretriever.melissadata.net/web/V1/NewMovers/doLookup
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X POST \
https://dataretriever.melissadata.net/web/V1/NewMovers/doLookup \
-H 'Content-Type: application/json' \
-d '{
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Includes": {
"Zips": [
{
"Zip": "92688"
}
],
"MoveEffectiveDate": {
"StartDate": "2023/01/01",
"EndDate": "2024/01/01"
}
},
"Columns": [
"MelissaAddressKey",
"AddressLine",
"PreviousAddressLine"
],
"Pagination": {
"Page": 1
}
}'Response
application/json
{ "Count": 370, "Results": [ { … }, { … } ], "Pagination": { "CurrentPage": 1, "NextPage": 2, "TotalPages": 3 }, "JobId": "returned_job_id", "ResultCode": "LS01" }
Bodyapplication/jsonrequired
The License Key issued by Melissa.
Any parameter you would like to include in the query.
Requires at least one from:
- CensusKey
- Zips
- Cities
- Radius
- ShapeWKTs
A list of Zips objects containing Zip codes and optionally Plus4.
A Radius object containing a Latitude, Longitude, and Distance represented in miles.
A list of BaseMelissaAddressKeys.
A list of PreviousMelissaAddressKeys.
A list of PreviousBaseMelissaAddressKeys.
A list of EstimatedHouseholdIncomeCodes.
A list of EstimatedHousingValueCodes.
A list of PresenceOfChildrenCodes.
A list of DwellingSpecificCodes.
All NewMovers Columns you want returned.
Items Enum"MelissaAddressKey""BaseMelissaAddressKey""FullName""FirstName""MiddleName""LastName""AddressLine""City""State""ZIPCode"
- Data Retriever Serverhttps://dataretriever.melissadata.net/web/V1/NewMovers/getCount
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X POST \
https://dataretriever.melissadata.net/web/V1/NewMovers/getCount \
-H 'Content-Type: application/json' \
-d '{
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Includes": {
"Zips": [
{
"Zip": "92688"
}
],
"MoveEffectiveDate": {
"StartDate": "2023/01/01",
"EndDate": "2024/01/01"
}
},
"Columns": [
"MelissaAddressKey",
"AddressLine",
"PreviousAddressLine"
]
}'Response
application/json
{ "JobId": "returned_job_id", "Count": 370, "ResultCode": "LS01", "Sample": [ { … }, { … } ] }