LeadGen Business:Response

From Melissa Data Wiki
Revision as of 17:31, 14 July 2015 by Admin (talk | contribs)
Jump to navigation Jump to search

← LeadGen Cloud API

LeadGen Business Navigation
Introduction
Request Parameters
XML Response
List/File
Business Result Codes



Return Elements

Returned for both get-count and buy-list requests:

XML Element XML Description
<Business> Tag encapsulating the whole XML document.
<Geography> Geo request
<City>

Requests within Geo Selects. Tags returned depend on Geo type.

<County>
<State>
<ZIP>
<Options>
<ContactPersonInfo>
<ContactPersonInfo>
  • one per business
  • all contacts
<NumberOfEmployees>
<IncludeAll> OR <Details> Default output is <IncludeAll>True</IncludeAll>, unless details options are specified in request. For example, <Details>100 – 249;500 – 999;5,000 - 9,999</Details> would be shown with all chosen options separated by semi colon.
<AppendToFile> True or False
<SalesVolumes> Various ranges of annual sales volumes
<IncludeAll> OR <Details> Default output is <IncludeAll>True</IncludeAll>, unless details options are specified in request. For example, <Details>$10,000,000-$19,999,999;$50,000,000-$99,999,999;$500,000,000-$999,999,999</Details> would be shown with all chosen options separated by semi colon.
<AppendToFile> True or False
<SICCodes> 6-digit SIC code
<IncludeAll> OR <Details> Default output is <IncludeAll>True</IncludeAll>, unless details options are specified in request. For example, <Details>CONSTRUCTION-SPECIAL TRADE CONTRACTORS;NONCLASSIFIED ESTABLISHMENTS;CREDIT & DEBT COUNSELING SERVICES</Details> would be shown with all chosen options separated by semi colon.
<AppendToFile> True or False
<AdditionalAppend>
<ContactName> True or False. See Other Purchase Options for options.
<FaxNumber> True or False. See Other Purchase Options for options.
<Phone> True or False. See Other Purchase Options for options.
<NAICS> True or False. See Other Purchase Options for options.
<KeyExecutive> True or False. See Other Purchase Options for options.
<NumberOfEmployees> True or False. See Other Purchase Options for options.
<EstimatedSales> True or False. See Other Purchase Options for options.
<CountDetails>
<StreetRange> Contains a breakdown of the street range.
<Street> Individual streets.
<StartNumber> For Geo types radius. Shows the starting street number and ending street number in the count.
<EndNumber>
<Geography>

Location of count detail. The location varies by the request type:

  • ZIP type returns Zip plus 4.
  • City type returns city, state.
  • County type returns county, state.
  • State type returns state.
  • Radius type returns street, city, state
<Zip> For radius type only.
<Count>

Location of count detail. The location varies by the request type:

  • ZIP type returns Zip plus 4.
  • City type returns city, state.
  • County type returns county, state.
  • State type returns state.
  • Radius type returns street.
<Addresses> Only returned with Radius when strzip is specified. Contains a breakdown of the addresses returned.
<Address> Individual addresses.
<Count>

Location of count detail. The location varies by the request type:

  • ZIP type returns Zip plus 4.
  • City type returns city, state.
  • County type returns county, state.
  • State type returns state.
<TotalCount> Total number of records returned with the selected options.
<Order> Buy Requests Only. Order details for a Buy request.
<Id> Order Id.
<Usage> Set by "multi" URL parameter. One or multi usage specified in buy call. See Other Purchase Options for details.
<DownloadURL> The URL to download the purchased file.
<PONumber> Set by "po" URL parameter. Returned if po is specified. See Other Purchase Options for details.
<DeliveredQty> Number of records returned.
<Result> See Business Result Codes for details.
<StatusCode> See Status Codes for details.
<Errors> If <StatusCode> returns Err.
<Error> See Error Codes for details.
<ErrorCode>
<ErrorDescription>


Examples

An example (from the buy list call in section 1):

<Business>
  <Geography>
    <ZIP>92688</ZIP>
  </Geography>
  <Options>
    <ContactPersonInfo>
      <ContactPersonInfo>One per Address</ContactPersonInfo>
    </ContactPersonInfo>
    <NumberOfEmployees>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </NumberOfEmployees >
    <SalesVolumes>
      <Details>$5,000,000-$9,999,999</Details>
      <AppendToFile>False</AppendToFile>
    </SalesVolumes >
    <SICCodes>
      <IncludeAll>True</IncludeAll>
      <AppendToFile>False</AppendToFile>
    </SICCodes>
    <AdditionalAppend></AdditionalAppend>
  </Options>
  <TotalCount>
    <Count>63/Count>
  </TotalCount>
  <Order>
    <Id>123456</Id>
    <Usage>1</Usage>
    <DownloadURL>ftp://w10.melissadata.com/ListOrderFiles/123456.csv</DownloadURL>
    <DeliveredQty>63</DeliveredQty>
  </Order>
  <Result>
    <StatusCode>Approved</StatusCode>
  </Result>
</Business>