INTRODUCTION:

This document details how to implement the web results feed for xml and json formatted results.

There is also a JS AdUnit for web results described here: http://validclick.com/validclick-javascript-implementation-instructions

FEED CALL BREAKDOWN:

http://feed.validclick.com/

?affid=1                                    (affiliate id assigned to you by Inuvo, REQUIRED)

&xtype=3                                 (NonPaid feed designator , REQUIRED)

&search=cars                          (search term, * URL-ENCODE , REQUIRED)

&ip=1.1.1.1                                  (Users IP address, REQUIRED)

&agent=Mozilla                        (Users UserAgent value, * URL-ENCODE, REQUIRED)

&serveurl=www.test.com        (Url Where Listings are displayed, * URL-ENCODE, REQUIRED)

&xformat=json                          (return data format xml or json)

&maxcount=10                          (count of restult requested)

&start=1                                      (position to start at in result set, offset to page result set)

 

XML FORMAT RESPONSE  EXAMPLE

http://feed.validclick.com/?affid=1&search=cars&maxcount=10&start=1&xtype=3&xformat=xml&ip=1.1.1.1&agent=Mozilla&serveurl=www.test.com

Json FORMATED RESPONSE EXAMPLE

http://feed.validclick.com/?affid=1&search=cars&maxcount=10&start=1&xtype=3&xformat=json&ip=1.1.1.1&agent=Mozilla&serveurl=www.test.com

NOTES: For both Json and XML formats you must urldecode the Link value, and html_entity_decode the TITLE and DESCRIPTION values for display.


{"LISTING": [
{
"RANK": "1",
"TITLE": "New <b>Cars</b>, Used <b>Cars</b>, <b>Car</b> Reviews | <b>Cars</b>.com",
"DESCRIPTION": "Use <b>Cars</b>.com to search 2.6 million new &amp; used <b>car</b> listings or get a dealer quote. Our easy-to-use online tools put you a step ahead in your next vehicle purchase.",
"SITEHOST": "www.cars.com",
"LINK": "http%3A%2F%2Ffeed.validclick.com%2Fgen.php%3Fdst%3DvMXV5G2TZKna2oKv2tejgNrc5WM%253D%26key%3Dtag-1-0-901231369859%26affID%3D1%26id%3DLFPvAffVC0%26sitehost%3Dwww.cars.com"
},
{
"RANK": "2",
........

------------------------------------------------------------

<?xml version="1.0" encoding="UTF-8"?>
<RESULTS>
<LISTING>
<RANK>1</RANK>
<TITLE>New &lt;b&gt;Cars&lt;/b&gt;, Used &lt;b&gt;Cars&lt;/b&gt;, &lt;b&gt;Car&lt;/b&gt; Reviews | &lt;b&gt;Cars&lt;/b&gt;.com</TITLE>
<DESCRIPTION>Use &lt;b&gt;Cars&lt;/b&gt;.com to search 2.6 million new &amp;amp; used &lt;b&gt;car&lt;/b&gt; listings or get a dealer quote. Our easy-to-use online tools put you a step ahead in your next vehicle purchase.</DESCRIPTION>
<SITEHOST>www.cars.com</SITEHOST>
<LINK>http%3A%2F%2Ffeed.validclick.com%2Fgen.php%3Fdst%3DvMXV5G2TZKna2oKv2tejgNrc5WM%253D%26key%3Dtag-1-0-74533585652%26affID%3D1%26id%3DLFPvAffVC0%26sitehost%3Dwww.cars.com</LINK>
</LISTING>
<LISTING>
<RANK>2</RANK>
........