Enhanced Click Implementations

The Katch Search REST API allows you to query listings from our marketplace platform. The API is served over HTTPS.

Since the API is based on REST principles, it’s very easy to write and test applications. You can use your browser to access URLs, and you can use pretty much any HTTPS client in any programming language to interact with the API.

Service URL

To use this service you need to make an HTTP POST REQUEST to the following URL:

https://marketplaces.katch.com/enhanced/search

You need to send a JSON Request Body as follows:

{"campaign": string,"md": string,"state":string}

Example of request:


POST https://marketplaces.katch.com/enhanced/search
Accept: application/xml
Content-Type: application/json

Request Body:
{"campaign": "6604","md":"6","state":"CA"}

Query String Parameters

(Parameters indicated with a “++” are mandatory)

  • ++md = Marketplace definition identifier. The MD for this implementation is (6)
  • ++state = Specific state marketplace to query. Value needs be sent in state code format. (example -> state = CA)
  • ++campaign = Campaigns are used to track separate implementations, placements or traffic sources. The Campaign ID for this implementation is (xxxxx)
  • zipcode = Use this parameter to pass the location of the user making the query. This can only be the zip code in its 5 digit format.(e.g., “zipcode”: 90210)
  • publisherid = This is your Publisher ID, and it will be assigned when you register on Katch’s Platform. Your Publisher ID is (xxxxx)
  • maxresults = Indicates the max number of results intended for the visitor to see. (e.g. “maxResults”: “8”)
  • engagementoption = This filter will allow you to obtain different types of engagements: clicks, calls or both. When not specified, it will default to clicks only. See Table for Reference.
Value Meaning Example of parameter with value
1 Click “engagementoption” : “1”
2 Call “engagementoption” : “2”
4 Click and Call “engagementoption” : “4”
  • ++ client_user_agent: The software agent making the request.
  • client_referrer: This header field allows the client to specify, the address ( URI ) from which the the request was made.
  • client_ip: The IP address that accessed the website.

Life Lead Fields

See Lead Fields and Values here.

Publisher Tracking Parameters

There are 5 available parameters for publisher tracking purposes (p1, p2, p3, p4, p5), these can be used to keep track of your traffic sources, unique visitor tracking, or any other value used to track publisher’s traffic. All data sent to these parameters, will be available in our platform reports.

Guidelines for the p1, p2, p3, p4, p5 parameters:

  • Length: 36 characters
  • Allowed characters: Letters, numbers, underscore and dash

Example of usage: (this is just an example)

  • “p1”: “paidtraffic”
  • “p2”: “21EC2020-3AEA-4069-A2DD-08002B30309D”
  • “p3”: “searchengine-123”
  • “p4”: “ty-page”
  • “p5”: “sidebar”

Example of query String with parameters and values

http://marketplaces.katch.com/enhanced/search?state=CA&zipcode=90210&campaign=6604&maxresults=15&md=6&client_user_agent=Mozilla/5.0+(Windows+NT+6.1;+WOW64;+Trident/7.0;+rv:11.0)+like+Gecko&client_referrer=yourdomain.com&client_ip=192.168.5.2&engagementoption=4&p1=paidtraffic&p2=21EC2020-3AEA-4069-A2DD-08002B30309D&p3=searchengine-123&p4=ty-page&p5=sidebar&format=xml

Super Bids Parameters

age

Indicates the user’s age. See Table for Reference.

Value Meaning Example of parameter with value
1 18-24 “age” : “1”
2 25-34 “age” : “2”
3 35-49 “age” : “3”
4 50-64 “age” : “4”
5 65+ “age” : “5”

applicantgender

Indicates if the user is Male or Female. See Table for Reference.

Value Meaning Example of parameter with value
1 Male “applicantgender” : “1”
2 Female “applicantgender” : “2”

BMI

Indicates the user Weight. See Table for Reference.

Value Meaning Example of parameter with value
1 Less than 18.5 -Underweight “BMI” : “1”
2 18.5 to 24.9 -Normal “BMI” : “2”
3 25 to 29.9 -Overweight “BMI” : “3”
4 Greater than / equal to 30 -Obese “BMI” : “4”

healthconditions

Indicates if the user has Health Conditions or not. See Table for Reference.

Value Meaning Example of parameter with value
1 Yes “healthconditions” : “1”
2 No “healthconditions” : “2”

coveragetype

Indicates the Coverage Type selected by the user. See Table for Reference.

Value Meaning Example of parameter with value
1 Term Life “coveragetype” : “1”
2 Variable Life “coveragetype” : “2”
3 Whole Life “coveragetype” : “2”
4 Universal Life “coveragetype” : “2”
5 Accidental Death & Dismemberment “coveragetype” : “2”

maritalstatus

Indicates if the user is Single or Married. See Table for Reference.

Value Meaning Example of parameter with value
1 Single “maritalstatus” : “1”
2 Married “maritalstatus” : “2”

tobaccouse

Indicates if the user is Tobacco Use or not. See Table for Reference.

Value Meaning Example of parameter with value
1 Never “tobaccouse” : “1”
2 Current User “tobaccouse” : “2”
3 Within the past year “tobaccouse” : “3”
4 Over 5 years ago “tobaccouse” : “4”

No Index/ No follow Listings

We strongly recommend to not index the listings by any bot because it may be reflected in your overall traffic quality and penalizations on behalf of our advertisers may be applied, to avoid that add “no follow” to the REL attribute in every listing.

<a href="Advertiser_click_URL" rel="nofollow" target="_blank"></a>

Handling Errors

If there is an error in the request (missing parameters, headers, wrong data in parameters) the XML Structure of Listings will not be returned. Instead the following error message structure can be returned:

Error output format:


<?xml version="1.0" encoding="UTF-8"?>
<ListingsResult xmlns="http://schemas.datacontract.org/2004/07/Public.Commons.AbstractProtocol.EduSearch.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<OpenMatchListings i:nil="true" />
<ResponseStatus>
<ErrorCode xmlns="">1</ErrorCode>
<Message xmlns="">Invalid Marketplace Definition Id</Message>
<Status xmlns="">Error</Status>
</ResponseStatus>
<Results />
</ListingsResult>

Error codes and messages

Error Code Error Name Exception Class
1 Internal Server Error InternalServerErrorExcpetion : PerformanceMarketException
2 Invalid Input InvalidInputException : PerformanceMarketException
3 Validation Error ValidationErrorException : PerformanceMarketException

Enhanced Clicks Data

Publishers who wish to implement Enhanced Clicks may see an increase in revenue per visitor, as their media will convert better for Katch advertisers. To include Enhanced Clicks data in the request to the Katch System to receive the XML feed:

Mandatory Parameters:

Value Meaning Example of parameter with value
ECDataType Indicates the scheme for Enhanced Clicks “ECDataType” : “Life”
Ecdata Structure for enhanced clicks information “ECData” : “{\“zipcode\”:\“90210\”,\“firstname\”:\”TestA\”}”

Enhanced Clicks Parameters (for “Ecdata”):

Field Name Values
zipcode For US: #####-#### or ##### (can start with 0)
firstname Varchar(50)
lastname Varchar(50)
address1 Varchar(100)
address2 Varchar(100)
city Varchar(50)
state Valid State. Varchar(20)  
phone Valid US Phone. 10 Digits   
###-###-####
email   Valid email. Varchar (100)  
For example:user@email.com
gender   0 = Male
1 = Female
heightft   #  
heightin   #  
weight   #  
birthday   Date (month/day/year, 09/23/1977)  
maritalstatus   0 = Single
1 = Married
2 = Divorced
3 = Separated
4 = Widowed
5 = Domestic Partner
6 = Other
coveragetype 0 = Burial Expense
1 = Term
2 = Whole
3 = Variable
4 = Universal
5 = Not Sure
hashealthconditions 0 = Yes  
1= No 
tobaccouse   0 = Yes  
1= No 
policyamount #  
selfemployed   0 = Yes  
1= No 
healthconditions 0 = AIDS/HIV
1 = Diabetes Type 1
2 = Diabetes Type 2
3 = Liver Disease
4 = Alzheimer’s Disease
5 = Lung Disease
6 = Drug Abuse
7 = Mental Illness
8 = Cancer
9 = Heart Disease
10 = Stroke
11 = Depression
12 = Kidney Disease
13 = Supplemental Oxygen
14 = Other
15 = No
lengthofterm 0 = Burial Expense
1 = 1 Year
2 = 5 Years
3 = 10 Years
4 = 15 Years
5 = 20 Years
6 = 25 Years
7 = 30 Years
8 = Whole Life
9 = Universal Life
10 = Cash Value
11 = Not Sure
hazardouslifestyle 0 = Yes  
1= No 
ismilitary 0 = Yes  
1= No 
medication 0 = Yes  
1= No 
dui 0 = Yes  
1= No 
currentlyynsured 0 = Yes  
1= No 

The request Body should contain a structure of data as follows:

{"campaign": "String", "state": "String", "ecdata":"String", "zipcode": "String", "format": "String" }

Sample with Values:


{
"campaign" : "6604",
"state" : "CA",
"publisherid" : "55555",
"zipcode" : "90210",
"md" : "6",
"age" : "1",
"BMI" : "2",
"healthconditions" : "1",
"P1" : "123456789",
"ecdata" : "{\"ZipCode\": \"90210\", \"Address1\":\"123 Fake St\",\"HasHealthConditions\":\"1\"}",
"ECDataType" : "Life",
"format":"xml"
}

Example of POST:


Header:
Content-Type: application/json

Body:

{
"campaign" : "6604",
"state" : "CA",
"publisherid" : "55555",
"zipcode" : "90210",
"md" : "6",
"age" : "1",
"BMI" : "2",
"healthconditions" : "1",
"P1" : "123456789",
"ecdata" : "{\"ZipCode\":\"90210\",\"FirstName\":\"TestA\",\"LastName\":\"TestA\",\"Address1\":\"Fake 123\",\"City\":\"Beverly Hills\",\"State\":\"CA\",\"Phone\":\"3103201351\",\"Email\":\"jshmit@katchtest.com\",\"Gender\":\"0\",\"HeightFT\":\"5\",\"HeightIN\":\"5\",\"Weight\":\"180\",\"Birthday\":\"12\/12\/1980\",\"MaritalStatus\":\"0\",\"CoverageType\":\"5\",\"TobaccoUse\":\"1\",\"PolicyAmount\":\"500\",\"HasHealthConditions\":\"1\",\"LengthOfTerm\":\"11\",\"IsMilitary\":\"0\",\"Medication\":\"0\",\"DUI\":\"0\",\"CurrentlyInsured\":\"0\"}",
"ECDataType" : "Life",
"format" : "xml",

}

Example of Response:


<?xml version="1.0" encoding="UTF-8"?>
<ListingsResult xmlns="http://schemas.datacontract.org/2004/07/Public.Commons.AbstractProtocol.EduSearch.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<OpenMatchListings />
<ResponseStatus>
<Status xmlns="">Ok</Status>
</ResponseStatus>
<Results>
<OutPutListing xmlns="">
<BrandName>New York Life Insurance Company</BrandName>
<Description>
<Element>From $10,000 to $100,000 in affordable coverage for ages 50-74.</Element>
<Element>No medical exam - acceptance is based on answers to a few health questions and other information we collect</Element>
<Element>No waiting period</Element>
<Element>Group coverage exclusively for AARP members. If you're not a member it's easy to join - we'll send you everything you need</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.nylaarp.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_106492</EngagementId>
<HeadLine>California Residents: AARP Life Insurance Program from New York Life Insurance Company</HeadLine>
<ListingId>106492</ListingId>
<LogoUrl>//cdn.katch.com/logos/77852.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_106492&amp;pos=1</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/106492/aHR0cDovL3d3dy5ueWxhYXJwLmNvbS9icm9rZXJzd2ViLzIwMTUvMTM_c291cmNlPXtzb3VyY2VfaWR9</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>GMAD</BrandName>
<Description>
<Element>Coverage for Adults or Children</Element>
<Element>No Medical Exam. Just a Few Y/N Health Questions.</Element>
<Element>Free Information. No Phone Required. No Waiting.</Element>
<Element>Buy Direct. Monthly Rates as low as $3.49 for Adults/$2.17 for Children</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>GlobeLifeInsurance.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_301079</EngagementId>
<HeadLine>$1* Buys $50,000 Globe Life Insurance</HeadLine>
<ListingId>301079</ListingId>
<LogoUrl>//cdn.katch.com/logos/258002_254.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_301079&amp;pos=2</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/301079/aHR0cDovL2YwajguZ2xvYmVsaWZlaW5zdXJhbmNlLmNvbS8_c3RhdGU9Q0EmZ21hZF9pZD1ia3ctODE3MDM2JnNyYz17c291cmNlX2lkfSZ6aXBjb2RlPTkwMjEwJm14ZnY9ZnQmZXhsbXQ9dHImc3Vic3ViaWQ9e3NvdXJjZV9zdWJpZH0.</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>American National Insurance Company</BrandName>
<Description>
<Element>Get an instant rate quote and apply today.</Element>
<Element>Ages 18 to 69.</Element>
<Element>Personalized service. Privacy guaranteed.</Element>
<Element>Skip the middleman. Buy directly from the company.</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>ANICODirect.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_389405</EngagementId>
<HeadLine>Great Life Insurance is only a click away when you buy directly from American National Insurance Company</HeadLine>
<ListingId>389405</ListingId>
<LogoUrl>//cdn.katch.com/logos/328191.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_389405&amp;pos=3</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/389405/aHR0cHM6Ly9hY2Nlc3MuYW5pY28uY29tL2dzbGlmZS9hbmljb2RpcmVjdHBvcy9pbml0UHJvYy5kaHRtbD9wcm9jPWZhc3RRdW90ZSZvZ249bGlmZWluc3VyYW5jZW9yZyZzdWJpZD17c291cmNlX2lkfT8_</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>LifeInsuranceDirect.com</BrandName>
<Description>
<Element>Instantly compare rates using our free quote service</Element>
<Element>We represent 13 trusted companies to shop the best rates</Element>
<Element>Guaranteed acceptance policies available! No medical exam required</Element>
<Element>Up to $50,000 in coverage available for ages 45-85</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>LifeInsuranceDirect.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_371373</EngagementId>
<HeadLine>Compare Final Expense Life Insurance Quotes, Save Up to 70%!</HeadLine>
<ListingId>371373</ListingId>
<LogoUrl>//cdn.katch.com/logos/318543_2.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_371373&amp;pos=4</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/371373/aHR0cHM6Ly93d3cubGlmZWluc3VyYW5jZWRpcmVjdC5jb20vZ2V0LXF1b3Rlcy9maW5hbC1leHBlbnNlP1NSQz10el9saWRfYnJva2Vyc3dlYiZQdWJfSUQ9e3NvdXJjZV9pZH0mU3ViX0lEPUZF</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>New York Life - Agent</BrandName>
<Description>
<Element>A free, no-obligation meeting with a trained New York Life agent in your area</Element>
<Element>A variety of life insurance policies, as well as retirement income alternatives</Element>
<Element>Provide your family with insurance protection that can last a lifetime</Element>
<Element>Complete a simple form and an agent will contact you shortly</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.newyorklife.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_397425</EngagementId>
<HeadLine>Want to talk with a financial professional? Discuss your needs with one of our agents</HeadLine>
<ListingId>397425</ListingId>
<LogoUrl>//cdn.katch.com/logos/78541.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_397425&amp;pos=5</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/397425/aHR0cDovL3d3dy5uZXd5b3JrbGlmZS5jb20vbGlmZS1pbnN1cmFuY2UtYnd2bi10Lz9jbXBpZD1hZmMyMDE1MDUyN2J3YiZzb3VyY2U9Ymt3X3tzb3VyY2VfaWR9ICA.</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>Apollo Interactive</BrandName>
<Description>
<Element>Affordable Quotes From Top Companies</Element>
<Element>MetLife, Prudential, AARP, New York Life &amp; More</Element>
<Element>Compare Term, Whole, Variable &amp; Universal Plans</Element>
<Element>Get Your FREE Quote Now or Call (866) 645-8836</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.GreatLifeInsuranceGroup.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_88603</EngagementId>
<HeadLine>Compare Great California Life Insurance</HeadLine>
<ListingId>88603</ListingId>
<LogoUrl>//cdn.katch.com/logos/71889.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_88603&amp;pos=6</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/88603/aHR0cDovL3d3dy5ncmVhdGxpZmVpbnN1cmFuY2Vncm91cC5jb20vY29tcGFyZS9pbmRleC5waHA_UmVmZXJyZXI9QlcmU3VicmVmZXJyZXI9V0tEWSZTdWJpZD1DR1NMSSZ1dG1fc291cmNlPWJyb2tlcnN3ZWImdXRtX21lZGl1bT1jcGMmdXRtX2NhbXBhaWduPXdlZWtkYXkmemlwPTkwMjEwJlBQQ19DTElDS19JRD17ZW5nYWdlbWVudGlkfSZQUENfU09VUkNFPXtzb3VyY2VfaWR9IA..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>Rev Impact, Inc. - 2703</BrandName>
<Description>
<Element>Up to $50K in Coverage, Ages 45-80 Only, Fast Free Quotes</Element>
<Element>No Medical Exam Required, Just a Few Simple Health Questions</Element>
<Element>Guaranteed Acceptance, Shop Rates &amp; Protect Your Family Today</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.funeralinsurancerates.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_113533</EngagementId>
<HeadLine>Burial Insurance Quotes $2,000 to $50,000 Available!</HeadLine>
<ListingId>113533</ListingId>
<LogoUrl>//cdn.katch.com/logos/80213.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_113533&amp;pos=7</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/113533/aHR0cDovL3d3dy5mdW5lcmFsaW5zdXJhbmNlcmF0ZXMuY29tLz9pZD1idzA3Jms9</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>Benepath</BrandName>
<Description>
<Element>Compare Life Insurance Quotes from All the Top Carriers in California</Element>
<Element>Work With a Local Agent to Get the Most Affordable Plan for Your Family</Element>
<Element>Get a Free Quote Today</Element>
<Element>Click to Get Started or Call 888-423-6437 to Talk to a Live Agent!</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.Compare-Life-Quotes.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_87832</EngagementId>
<HeadLine>Get an Affordable Life Insurance Plan for as low as $22</HeadLine>
<ListingId>87832</ListingId>
<LogoUrl>//cdn.katch.com/logos/71632.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_87832&amp;pos=8</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/87832/aHR0cDovL3d3dy5jb21wYXJlLWxpZmUtcXVvdGVzLmNvbS9nZXQtbGlmZS1pbnN1cmFuY2UuYXNweD91dG1fc291cmNlPWJyb2tlcnN3ZWImdXRtX21lZGl1bT10YXJnZXRlZCUyMGNvbnRlbnQmdXRtX3Rlcm09Z2V0JTIwbGlmZSUyMGluc3VyYW5jZSZ1dG1fY29udGVudD1jb21wYXJlJTIwbGlmZSUyMGluc3VyYW5jZSUyMHF1b3RlcyUyMCZzdWJzb3VyY2U9e3NvdXJjZV9pZH0mR2VvVGFyZ2V0PUNBJnV0bV9jYW1wYWlnbj1saWZl</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>Apollo Interactive</BrandName>
<Description>
<Element>Affordable Life Insurance Plans From All Major Provider</Element>
<Element>MetLife, Prudential, AARP, New York Life, &amp; More</Element>
<Element>Term, Whole, Universal, and Variable Insurance Plans</Element>
<Element>Get Your FREE Quote Online or Call (877) 736-0534</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.lifeinsurancepro.org</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_398193</EngagementId>
<HeadLine>Compare California Life Insurance Plans</HeadLine>
<ListingId>398193</ListingId>
<LogoUrl>//cdn.katch.com/logos/306696.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_398193&amp;pos=9</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/398193/aHR0cDovL3d3dy5saWZlaW5zdXJhbmNlcHJvLm9yZy9pbmRleC5waHA_UmVmZXJyZXI9QlcmU3VicmVmZXJyZXI9V0tEWSZTdWJpZD1DU0xJUCZ6aXA9OTAyMTAmdXRtX3NvdXJjZT1icm9rZXJzd2ViJnV0bV9tZWRpdW09Y3BjJnV0bV9jYW1wYWlnbj13ZWVrZGF5JlBQQ19DTElDS19JRD17ZW5nYWdlbWVudGlkfSZQUENfU09VUkNFPXtzb3VyY2VfaWR9IA..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>InsWeb</BrandName>
<Description>
<Element>Find Affordable Life Insurance in Minutes</Element>
<Element>Protect Your Family For Only a Few Dollars a Day</Element>
<Element>Specialized Plans to Fit Every Need</Element>
<Element>Click To Get Your Quote Today!</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.life-insurance-plans.org</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_96475</EngagementId>
<HeadLine>Shop the CA Life Insurance Marketplace</HeadLine>
<ListingId>96475</ListingId>
<LogoUrl>//cdn.katch.com/logos/74513_601.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_96475&amp;pos=10</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/96475/aHR0cDovL3d3dy5saWZlLWluc3VyYW5jZS1wbGFucy5vcmcvP2N1cmw9bGlmZS1pbnN1cmFuY2UtcGxhbnMub3JnJmZyb209bGlmZS1pbnN1cmFuY2UtcGxhbnMmc2lkPVRFLUwtQlcyJmMxPUNBJmMyPWNyQQ..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>LifePlans.com</BrandName>
<Description>
<Element>$250k Term Policy for Just Pennies a Day!</Element>
<Element>Discounts for the Healthy and those under 55 Years Old</Element>
<Element>Save 70% - Protect Your Loved Ones.</Element>
<Element>Why Wait Any Longer?</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>LifePlans.com/California</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_342489</EngagementId>
<HeadLine>Top 10 Life Insurance Plans in California</HeadLine>
<ListingId>342489</ListingId>
<LogoUrl>//cdn.katch.com/logos/297135_209.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_342489&amp;pos=11</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/342489/aHR0cDovL3d3dy5MaWZlUGxhbnMuY29tL2Zvcm0vP3ppcD05MDIxMCZTUkM9bGlfYncmU3ViX0lEPXtzb3VyY2VfaWR9JkNJRD0yNDQwNyZid19zdGF0ZT1DYWxpZm9ybmlhJmFkdmVyPUFCTUk.</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>Benepath</BrandName>
<Description>
<Element>Compare Quotes From Over 8 Companies to Find the Best Plan For You</Element>
<Element>Rates as low as $14 per month for $250,000 in coverage</Element>
<Element>Get the Advice You Need to Secure Your Family's Future</Element>
<Element>Click Now to Get Started or Call 888-423-6437 to Talk to a Live Agent!</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.Benepath.com/LifeInsurance</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_87226</EngagementId>
<HeadLine>Compare Affordable Life Insurance Plans: Get the Best Rates Available in California</HeadLine>
<ListingId>87226</ListingId>
<LogoUrl>//cdn.katch.com/logos/71430.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_87226&amp;pos=12</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/87226/aHR0cDovL2xpZmVpbnN1cmFuY2UuYmVuZXBhdGguY29tL2xpZmUvYmVzdC1saWZlLWluc3VyYW5jZS1wbGFucy1uZXcuYXNweD91dG1fc291cmNlPWJyb2tlcnN3ZWImdXRtX21lZGl1bT10YXJnZXRlZCUyMGNvbnRlbnQmdXRtX3Rlcm09bGlmZSUyMGluc3VyYW5jZSUyMGRlYWxzJnV0bV9jb250ZW50PWxpZmUlMjBpbnN1cmFuY2UmR2VvVGFyZ2V0PUNBJnN1YnNvdXJjZT17c291cmNlX2lkfSZ1dG1fY2FtcGFpZ249bGlmZQ..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>National Agents Alliance</BrandName>
<Description>
<Element>Financial Security for Your Family</Element>
<Element>Fast, Free, No Obligation Quotes for California</Element>
<Element>Choose From the Top Insurance Providers in the Nation</Element>
<Element>100% Safe and Secure</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.naainsurance.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_373588</EngagementId>
<HeadLine>Save on Term Life Insurance in California!</HeadLine>
<ListingId>373588</ListingId>
<LogoUrl>//cdn.katch.com/logos/74910.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_373588&amp;pos=13</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/373588/aHR0cDovL2FkY2xpY2submFhbGVhZHMuY29tL2NsaWNrLnBocD9pZD0wMDAxMTEmYWQ9MDAwOTk4JlpDPTkwMjEwJlNUPUNBJlNDPXtzb3VyY2VfaWR9</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>US Paperless Systems, LLC</BrandName>
<Description>
<Element>Life Insurance With No Exam, Up to $500K Coverage, &amp; Low As $3.27/mo.</Element>
</Description>
<DescriptionType>Paragraph</DescriptionType>
<DisplayUrl>www.life-assurance-site.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_85606</EngagementId>
<HeadLine>Affordable Life Insurance</HeadLine>
<ListingId>85606</ListingId>
<LogoUrl>//cdn.katch.com/logos/70890.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_85606&amp;pos=14</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/85606/aHR0cDovL3d3dy5saWZlLWFzc3VyYW5jZS1zaXRlLmNvbS9saWZlaW5zdXJhbmNlMi9saWZlaW5zdXJhbmNlLmh0bQ..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>OnThree Enterprises, LLC</BrandName>
<Description>
<Element>Quote. Compare. Save!</Element>
<Element>Compare Insurance Quotes from Top Companies.</Element>
<Element>One Short Form can Save You up to 40%.</Element>
<Element>Start a Free Quote Online</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>USInsuranceAgents.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_99667</EngagementId>
<HeadLine>Compare Multiple Life Insurance Quotes Now - Save Up to 40%</HeadLine>
<ListingId>99667</ListingId>
<LogoUrl>//cdn.katch.com/logos/75577.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_99667&amp;pos=15</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/99667/aHR0cDovL3VzaW5zdXJhbmNlYWdlbnRzLmNvbS9yZWRpci8_aWQ9MTAwMDA5JnRpZD1id3VpbjEwMDEwNCZ6aXBDb2RlPTkwMjEwJnN0YXRlPUNBJnNvdXJjZT17c291cmNlX2lkfSZpbnNUeXBlPWxpZmU.</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>Fidelity</BrandName>
<Description>
<Element>Pay As Little As $15/Month for $250,000 in coverage</Element>
<Element>Competitive Rates: Save up to 70%</Element>
<Element>Protect Your Family with the Coverage You Hope They Never Need</Element>
<Element>Receive Free, No Obligation Life Insurance Quotes Today</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.ecoverage.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_340506</EngagementId>
<HeadLine>Affordable Life Insurance for California Residents</HeadLine>
<ListingId>340506</ListingId>
<LogoUrl>//cdn.katch.com/logos/296474_414.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_340506&amp;pos=16</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/340506/aHR0cDovL3JleHJrLmNvbS8_YT0xNjkwMiZjPTI3MzIwJnMxPVZNJnMyPXtzb3VyY2VfaWR9JnMzPXtlbmdhZ2VtZW50aWR9IA..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>OnThree Enterprises, LLC</BrandName>
<Description>
<Element>Shop Locally &amp; Save.</Element>
<Element>Compare Fast, Free &amp; Competitive Quotes from Local Agents</Element>
<Element>Representing Top National and Regional California Insurance Companies.</Element>
<Element>Save Up to 40%. Get Your Free Quotes Now!</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>www.InsuranceQuoteSpot.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_98452</EngagementId>
<HeadLine>Local California Insurance Agents Can Save You up to 40% on a Life Insurance Policy</HeadLine>
<ListingId>98452</ListingId>
<LogoUrl>//cdn.katch.com/logos/75172.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_98452&amp;pos=17</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/98452/aHR0cDovL2luc3VyYW5jZXF1b3Rlc3BvdC5jb20vcmVkaXIvP2lkPTEwMDAwNCZ0aWQ9YndpcXMxMzM2MjImaW5zVHlwZT1saWZlJnppcENvZGU9OTAyMTAmc3RhdGU9Q0Emc291cmNlPXtzb3VyY2VfaWR9JnN0YXRlQ29kZT1DQQ..</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
<OutPutListing xmlns="">
<BrandName>OnThree Enterprises, LLC</BrandName>
<Description>
<Element>One Quick, Easy and Hassle Free Life Insurance Form</Element>
<Element>Experienced Agents that Can Help You Select the Right Policy</Element>
<Element>Select the Coverage You Need. Get a Price You Can Afford.</Element>
<Element>Get the Protection You Need. Start Your Free Life Insurance Quote Now!</Element>
</Description>
<DescriptionType>Bulleted</DescriptionType>
<DisplayUrl>Insurancery.com</DisplayUrl>
<EngagementId>f8d024dd-afe1-40d6-9be9-bce6258bcb53_99064</EngagementId>
<HeadLine>California Life Insurance - Simple &amp; Affordable</HeadLine>
<ListingId>99064</ListingId>
<LogoUrl>//cdn.katch.com/logos/75376.gif?e=f8d024dd-afe1-40d6-9be9-bce6258bcb53_99064&amp;pos=18</LogoUrl>
<Products>
<Product>
<ActionUrl>//marketplaces.katch.com/click/f8d024dd-afe1-40d6-9be9-bce6258bcb53/99064/aHR0cDovL2luc3VyYW5jZXJ5LmNvbS9yZWRpci8_aWQ9MTAwMDE5JnRpZD1id2lueTEwOTAwOSZpbnNUeXBlPWxpZmUmemlwQ29kZT05MDIxMCZzdGF0ZT1DQSZzb3VyY2U9e3NvdXJjZV9pZH0.</ActionUrl>
<Type>Click</Type>
</Product>
</Products>
</OutPutListing>
</Results>
</ListingsResult>

Test and Development

At the time of testing, please always set the parameter “testTransaction” : “true”


Header:
Content-Type: application/json

Body:

{
"campaign" : "6604",
"state" : "CA",
"publisherid" : "55555",
"zipcode" : "90210",
"md" : "6",
"age" : "1",
"BMI" : "2",
"healthconditions" : "1",
"p1" : "123456789",
"ecdata" : "{\"zipcode\":\"90210\",\"firstname\":\"TestA\",\"lastname\":\"TestA\",\"address1\":\"Fake 123\",\"city\":\"Beverly Hills\",\"state\":\"CA\",\"phone\":\"3103201351\",\"email\":\"jsmith@katchtest.com\",\"gender\":\"0\",\"heightft\":\"5\",\"heightin\":\"5\",\"weight\":\"180\",\"birthday\":\"12\/12\/1980\",\"maritalStatus\":\"0\",\"coveragetype\":\"5\",\"tobaccouse\":\"1\",\"policyamount\":\"500\",\"hashealthconditions\":\"1\",\"lengthofterm\":\"11\",\"ismilitary\":\"0\",\"medication\":\"0\",\"dui\":\"0\",\"currentlyinsured\":\"0\"}",
"ECDataType" : "Life",
"format" : "xml",
"testTransaction" : "true"

}

For Support:

If you have any trouble setting this up, please contact us at implementations-support@katch.com.