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 list of Zips objects containing Zip codes and optionally Plus4.
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.
The number of employees who work at this place.
Estimates the number of employees who work at this location.
The deliverability status of the email address.
The marketable status of the email address.
The core based statistical area where the place is located.
Information on whether the CBSA is a micropolitan or metropolitan area.
The combined statistical area code where the place is located.
Describes the type of work an employee performs in their organization.
Descriptive label of the individual's job.
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 fields on the individual that are suppressed.
A list of the individual's job titles.
The date when the place opened for business.
Estimated opened for business lower.
Estimated opened for business upper.
Determine if the corporation includes franchised branches.
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 '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 list of Zips objects containing Zip codes and optionally Plus4.
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.
The number of employees who work at this place.
Estimates the number of employees who work at this location.
The deliverability status of the email address.
The marketable status of the email address.
The core based statistical area where the place is located.
Information on whether the CBSA is a micropolitan or metropolitan area.
The combined statistical area code where the place is located.
Describes the type of work an employee performs in their organization.
Descriptive label of the individual's job.
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 fields on the individual that are suppressed.
A list of the individual's job titles.
The date when the place opened for business.
Estimated opened for business lower.
Estimated opened for business upper.
Determine if the corporation includes franchised branches.
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 '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 list of Zips objects containing Zip codes and optionally Plus4.
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.
The number of employees who work at this place.
Estimates the number of employees who work at this location.
The deliverability status of the email address.
The marketable status of the email address.
The core based statistical area where the place is located.
Information on whether the CBSA is a micropolitan or metropolitan area.
The combined statistical area code where the place is located.
Describes the type of work an employee performs in their organization.
Descriptive label of the individual's job.
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 fields on the individual that are suppressed.
A list of the individual's job titles.
The date when the place opened for business.
Estimated opened for business lower.
Estimated opened for business upper.
Determine if the corporation includes franchised branches.
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 '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": [ { … }, { … } ] }