LeadGen Property V2:Request Parameters

From Melissa Data Wiki
Revision as of 21:57, 30 September 2019 by Admin (talk | contribs) (Created page with "{{LGXPropertyV2Nav}} {{CustomTOC}} ==Standard Components== {|class="alternate01" cellspacing="0" !Parameter !style="border-right:0px;"|Definition |- |Domain | |- |Version |...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

← 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


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]