# Data Retriever ## Overview 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** - [Data Retriever Documentation](https://docs.melissa.com/reference-data/data-retriever/data-retriever-index.html) **Useful Resources** - [Result Codes](https://docs.melissa.com/reference-data/data-retriever/data-retriever-reference-guide.html#result-codes) **Product Page** [https://www.melissa.com/data-retriever-cloud-api](https://www.melissa.com/data-retriever-cloud-api) **Support Center** [https://www.melissa.com/company/product-support](https://www.melissa.com/company/product-support) ## Servers Data Retriever Server ``` https://dataretriever.melissadata.net/web/V1 ``` ## Download OpenAPI description [Data Retriever](https://md-developer-portal-staging.redocly.app/_bundle/apis/data-retriever.yaml) ## MAK Use this endpoint to retrieve lists of addresses. ### Get total record count of addresses - [POST /MAK/doCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/mak/docountmak.md): This endpoint gets the total record count returned using the required and optional properties passed in. This endpoint does not count against the package usage. ### Get a paginated result view of addresses - [POST /MAK/doLookup](https://md-developer-portal-staging.redocly.app/apis/data-retriever/mak/dolookupmak.md): This endpoint returns a paginated result view of the request. This can sometimes take awhile and should be used after DoCount has been used to filter down your dataset. ### Get record count and sample of addresses - [POST /MAK/getCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/mak/getcountmak.md): This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset. ## NewMovers Use this endpoint to retrieve lists of new movers. ### Get total record count of new movers - [POST /NewMovers/doCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/newmovers/docountnewmovers.md): This endpoint gets the total record count returned using the required and optional properties passed in. This endpoint does not count against the package usage. ### Get a paginated result view of new movers - [POST /NewMovers/doLookup](https://md-developer-portal-staging.redocly.app/apis/data-retriever/newmovers/dolookupnewmovers.md): This endpoint returns a paginated result view of the request. This can sometimes take awhile and should be used after DoCount has been used to filter down your dataset. ### Get record count and sample of new movers - [POST /NewMovers/getCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/newmovers/getcountnewmovers.md): This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset. ## NewHomeowners Use this endpoint to retrieve lists of new homeowners. ### Get total record count of new homeowners - [POST /NewHomeowners/doCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/newhomeowners/docountnewhomeowners.md): This endpoint gets the total record count returned using the required and optional properties passed in. This endpoint does not count against the package usage. ### Get a paginated result view of new homeowners - [POST /NewHomeowners/doLookup](https://md-developer-portal-staging.redocly.app/apis/data-retriever/newhomeowners/dolookupnewhomeowners.md): This endpoint returns a paginated result view of the request. This can sometimes take awhile and should be used after DoCount has been used to filter down your dataset. ### Get record count and sample of new homeowners - [POST /NewHomeowners/getCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/newhomeowners/getcountnewhomeowners.md): This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset. ## Consumer Use this endpoint to retrieve lists of consumers. ### Get total record count of consumers - [POST /Consumer/doCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/consumer/docountconsumer.md): This endpoint gets the total record count returned using the required and optional properties passed in. This endpoint does not count against the package usage. ### Get a paginated result view of consumers - [POST /Consumer/doLookup](https://md-developer-portal-staging.redocly.app/apis/data-retriever/consumer/dolookupconsumer.md): This endpoint returns a paginated result view of the request. This can sometimes take awhile and should be used after DoCount has been used to filter down your dataset. ### Get record count and sample of consumers - [POST /Consumer/getCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/consumer/getcountconsumer.md): This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset. ## Consumer Two Use this endpoint to retrieve lists of consumers. ### Get total record count of consumers - [POST /ConsumerTwo/doCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/consumer-two/docountconsumertwo.md): This endpoint gets the total record count returned using the required and optional properties passed in. This endpoint does not count against the package usage. ### Get a paginated result view of consumers - [POST /ConsumerTwo/doLookup](https://md-developer-portal-staging.redocly.app/apis/data-retriever/consumer-two/dolookupconsumertwo.md): This endpoint returns a paginated result view of the request. This can sometimes take awhile and should be used after DoCount has been used to filter down your dataset. ### Get record count and sample of consumers - [POST /ConsumerTwo/getCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/consumer-two/getcountconsumertwo.md): This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset. ## Business Use this endpoint to retrieve lists of businesses. ### Get total record count of businesses - [POST /Business/doCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/business/docountbusiness.md): This endpoint gets the total record count returned using the required and optional properties passed in. This endpoint does not count against the package usage. ### Get a paginated result view of businesses - [POST /Business/doLookup](https://md-developer-portal-staging.redocly.app/apis/data-retriever/business/dolookupbusiness.md): This endpoint returns a paginated result view of the request. This can sometimes take awhile and should be used after DoCount has been used to filter down your dataset. ### Get record count and sample of businesses - [POST /Business/getCount](https://md-developer-portal-staging.redocly.app/apis/data-retriever/business/getcountbusiness.md): This endpoint allows API users to retrieve a count and 10 record sample of the results to preview before purchasing a file version of the full dataset.