LeadGen Property:Request Parameters

← LeadGen Cloud API

Standard Components

Parameter	Definition
Domain
Version	Web Service version.
Web Service	Property
Protocol	REST. The protocol used by the Web Service.
Action	"Get Count" or "Buy List"
Geographic type	ZIP, City, County, or Radius. See Geographic Types for more info.
Customer ID	The requester’s License Key or email address.
Options	Geographic Options Property Options General Options Other Purchase 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.

Authentication

Each License Key or email address is passed in as “id” in the URL. This is checked against the list of registered customers. If the required License Key has not been activated for LeadGen Property, the service will return <Status Code> with the value “Declined”.

Required

URL Parameter	Description
id	Required. User ID or Email Address. You must be subscribed to the Property Web Service.

Geographic Types

Each request must specify one of the following geographic types:

Don't forget! The call URL format: Property Call Format.

URL Parameter	Geographic Type	Description
zip?	Zip	Format: 5-digit ZIP or 9-digit ZIP+4 Multiple ZIP or ZIP+4 can be requested, comma separated with no space. Ex. zp=92688,85023,129265917
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