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:
- Zips
- Cities
- Radius
- ShapeWKTs
A Radius object containing a Latitude, Longitude, and Distance represented in miles.
Describes the contact's position relative to others in their organization.
Describes the contact's position relative to others in their organization.
The primary line of business represented by a Standard Industrial Classification code.
The line of business represented by a Standard Industrial Classification code.
The primary line of business represented by a North American Industry Classification System code.
The lines of business represented by North American Industry Classification System codes.
The actual, reported total number of employees at all locations in a corporate family.
Estimates the total number of employees at all locations in a corporate family.
Estimates the number of employees who work at this location.
Information on whether the CBSA is a micropolitan or metropolitan area.
Describes the type of work an employee performs in their organization.
The total number of Job titles associated with the contact.
Describes the contact's position relative to others in their organization.
The professional degree or title of the individual.
Information on whether the individual is the primary contact for the location.
The actual, reported sales revenue for the corporate family.
Estimates total sales revenue for the corporate family.
- Data Retriever Serverhttps://dataretriever.melissadata.net/web/V1/Business/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/Business/doCount \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Includes": {
"Cities": [
{
"City": "Rancho Santa Margarita",
"State": "CA"
},
{
"City": "Irvine",
"State": "CA"
}
],
"DeliverableEmail": true,
"RestaurantCuisines": [
"pizza",
"burgers"
]
}
}'Response
application/json
{ "Count": 108, "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:
- Zips
- Cities
- Radius
- ShapeWKTs
A Radius object containing a Latitude, Longitude, and Distance represented in miles.
Describes the contact's position relative to others in their organization.
Describes the contact's position relative to others in their organization.
The primary line of business represented by a Standard Industrial Classification code.
The line of business represented by a Standard Industrial Classification code.
The primary line of business represented by a North American Industry Classification System code.
The lines of business represented by North American Industry Classification System codes.
The actual, reported total number of employees at all locations in a corporate family.
Estimates the total number of employees at all locations in a corporate family.
Estimates the number of employees who work at this location.
Information on whether the CBSA is a micropolitan or metropolitan area.
Describes the type of work an employee performs in their organization.
The total number of Job titles associated with the contact.
Describes the contact's position relative to others in their organization.
The professional degree or title of the individual.
Information on whether the individual is the primary contact for the location.
The actual, reported sales revenue for the corporate family.
Estimates total sales revenue for the corporate family.
All Business Columns you want returned.
Items Enum"MelissaAddressKey""BaseMelissaAddressKey""Name""AddressLine""Suite""City""State""ZIPCode""Plus4""DeliveryPoint"
- Data Retriever Serverhttps://dataretriever.melissadata.net/web/V1/Business/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/Business/doLookup \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Includes": {
"Cities": [
{
"City": "Rancho Santa Margarita",
"State": "CA"
},
{
"City": "Irvine",
"State": "CA"
}
],
"DeliverableEmail": true,
"RestaurantCuisines": [
"pizza",
"burgers"
]
},
"Columns": [
"MelissaAddressKey",
"Name"
],
"Pagination": {
"Page": 1
}
}'Response
application/json
{ "Count": 108, "Results": [ { … }, { … } ], "Pagination": { "CurrentPage": 1, "NextPage": 0, "TotalPages": 1 }, "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:
- Zips
- Cities
- Radius
- ShapeWKTs
A Radius object containing a Latitude, Longitude, and Distance represented in miles.
Describes the contact's position relative to others in their organization.
Describes the contact's position relative to others in their organization.
The primary line of business represented by a Standard Industrial Classification code.
The line of business represented by a Standard Industrial Classification code.
The primary line of business represented by a North American Industry Classification System code.
The lines of business represented by North American Industry Classification System codes.
The actual, reported total number of employees at all locations in a corporate family.
Estimates the total number of employees at all locations in a corporate family.
Estimates the number of employees who work at this location.
Information on whether the CBSA is a micropolitan or metropolitan area.
Describes the type of work an employee performs in their organization.
The total number of Job titles associated with the contact.
Describes the contact's position relative to others in their organization.
The professional degree or title of the individual.
Information on whether the individual is the primary contact for the location.
The actual, reported sales revenue for the corporate family.
Estimates total sales revenue for the corporate family.
All Business Columns you want returned.
Items Enum"MelissaAddressKey""BaseMelissaAddressKey""Name""AddressLine""Suite""City""State""ZIPCode""Plus4""DeliveryPoint"
- Data Retriever Serverhttps://dataretriever.melissadata.net/web/V1/Business/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/Business/getCount \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Includes": {
"Cities": [
{
"City": "Rancho Santa Margarita",
"State": "CA"
},
{
"City": "Irvine",
"State": "CA"
}
],
"DeliverableEmail": true,
"RestaurantCuisines": [
"pizza",
"burgers"
]
},
"Columns": [
"MelissaAddressKey",
"Name"
]
}'Response
application/json
{ "JobId": "returned_job_id", "Count": 108, "ResultCode": "LS01", "Sample": [ { … }, { … } ] }