LeadGen Property V2:Request Parameters

← LeadGen Cloud API

LeadGen Property V2 Navigation
Introduction
Request Parameters
Response
Property Result Codes

Standard Components

Parameter	Definition
Domain
Version	V2
Web Service	Property
Protocol	REST
Action	"Get Count" or "Buy List"
Geographic type	ZIP, City, County, or Radius. See Geographic Types for more info.
Customer ID	The requester’s Customer ID, License Key, or Email Address.
Options	Geographic Options Property Options Mortgage Options Absentee/Owner Type Options Demographic Options General Options

Actions

The following actions are supported by the web service:

Action	Service Description
Get	Get the count of customers who fit the geographic and property criteria.
Buy	Buy a list of customers' info that fit the geographic and property criteria.

An example of this action in the URL:

https://list.melissadata.net/v2/Property/buy_zip?id=123456&zip=92688&propertype=10-11-22&bedrooms=2-4&occu=3

Authentication

Each Customer ID, License Key, or Email Address is passed in as id in the URL. This is checked against the list of registered customers.

Geographic Types

An example of this parameter in the URL

https://list.melissadata.net/v2/Property/count_zip?id=123456&zip=92688&propertype=10-11-22&bedrooms=2-4&occu=3

Each request must specify one of the following geographic types:

Type	Sub Types	Description
zip	ZIP(s)	5-digit ZIPs Multiple ZIP can be requested, comma separated with no space or period.
	ZIP in Radius	5-digit ZIP Miles of radius from any given ZIP (mile in decimal).
	ZIP(s) in City	5-digit ZIP, City, and 2-digit State.
address
city?	City	Format: 2-digit state;city name Multiple cities be requested, comma separated with no space. Ex. city=TX;Dallas,TX;Houston,TX;Austin
county?	County	Format: 2-digit state;county name Multiple counties be requested, comma separated with no space. Ex. county=CA;Lake,AZ;Mohave,AZ;Maricopa
radius?	Radius	Miles of radius from a given address, or the closest records to a given address.

Options

Each request takes a set of geographic input. Property and other input are optional with default values, as well as purchase options. See Columns in File for the format of all columns appended to file.

Geographic Options

URL Parameter	Geographic Type	Description
zip	Required: zip Optional: radius	Each five-digit ZIP is validated. Plus4 is a filter in the data section.
city	Required: city Optional: radius	Each city and state combinations is validated.
county	Required: county	Each county and state combination is validated. FIPS is retrieved if valid.
addr	Required: radius	Exact street number and street name are used in the data section. No validation. Latitude and longitude are retrieved if the address exists.
mile	Optional: radius (One of the two should be given, not required together.)	Mile is used to find out the latitudes/longitudes of a parameter so many miles from the given address.
records		Number of records that are the closest to the given address.

Property Options

URL Parameter	Description	Default Value	Optional Output Parameter
opt	Extra data added to the file returned: basic or detailed. When not mentioned, the simplest set of data is returned for those who have not opted out mail: owner names, property and mailing addresses.	opt=0 (Basic)	opt=1 (Detailed)
occu	Append OccupantType to file.	occu=0	To append: occu=1
occu-d	Occupant types: 1 = Absentee only 2 = Owner occupied	All, including unknown.
mval	Market value. Specify with the index and use ‘-‘ dash to specify multiple choices: mval=2-3-4	all	Value Definition 1 $1 - 49,999 2 $50,000 - 99,999 3 $100,000 - 149,999 4 $150,000 - 199,999 5 $200,000 - 249,999 6 $250,000 - 299,999 7 $300,000 - 349,999 8 $350,000 - 399,999 9 $400,000 - 449,999 10 $450,000 - 499,999 11 $500,000 - 574,999 12 $575,000 - 649,999 13 $650,000 - 724,999 14 $725,000 - 799,999 15 $800,000 - 899,999 16 $900,000 - 999,999 17 $1,000,000 - 1,999,999 18 $2,000,000+
ptype	Property type. To specify the index; use ‘-‘ dash to specify multiple choices, i.e. ptype =1-2	all	Value Definition 1 Single Family Residence/Townhouse 2 Condominium (residential) 3 Commercial 4 Duplex, Triplex, Quadplex 5 Apartment 6 Hotel, Motel 7 Commercial (condominium) 8 Retail 9 Service (general public) 10 Office Building 11 Warehouse 12 Financial Institution 13 Hospital (medical complex, clinic) 14 Parking 15 Amusement-Recreation 16 Industrial 17 Industrial Light 18 Industrial Heavy 19 Transport 20 Utilities 21 Agricultural 22 Vacant 23 Exempt 24 Miscellaneous 25 Not Available / None
sdt	Sale date.	no filter	To specify a period, use MYYYY. The start month starts on the 1st; the end month ends on the last day, i.e. sdt=32010-122014, this covers 3/1/2010 to 12/31/2014.
mdt	Mortgage date	no filter	To specify a period, use MYYYY. The start month starts on the 1st; the end month ends on the last day, i.e. mdt=32010-122014, this covers 3/1/2010 to 12/31/2014.

Purchase Options

The following options are for buy requestes only.

URL Parameter	Description	Default Value	Optional Output Parameter
multi	Buy Requests Only. By default, purchased lists may be used once. With this parameter included in the Buy call, you can purchase the right to use a list for multiple mailings. Specify the number of uses like this: multi=4. The maximum number of uses allowed for any purchased list is 5.	multi=1	multi=(1 through 5)
file	Buy Requests Only. Defines the desired file format of a purchased list.	file= 8	Value File Format 2 Zipped .txt 3 Zipped .csv 4 Zipped .xls (Excel) 7 .txt 8 (Default) .csv 10 .xls (Excel)
po	Buy Requests Only. Defines the customer’s purchase order number.	N/A	To specify: po=xxxx

General Options

URL Parameter	Description	Default Value	Optional Output Parameter
dbug	Parameter check. If a parameter in the url is spelled wrong or not suited for the given call, the request will be rejected.	dbug=0	To check: dbug=1

[[Category:LeadGen Property] V2]