The Result Set

The results received will be in an XML response. How many results are returned and their types is dependent on the query submitted and the CoBrand’s settings. For changes to CoBrand settings, contact your Partnership Manager.

The query results are returned in an XML format and are UTF-8 encoded.

A typical structure of the XML response is:

  • <search-results> – This holds everything, including Error Messages
    • <details> – This is basic details about the query. See Query Details Node
    • <collection> – This holds one or more groups of results
      • <group> – A group of results, denoting which search category (e.g. web, images, or related) the results are for, how it’s ordered (e.g. relevance), it’s type (e.g. main or extra-cat) and in which region it should be displayed (e.g. top).
        Note: Groups may be nested inside other groups.

        • <details> – Details about this particular group, such how many items are in it and the result count or the start and end position of the results. See Result Count Details Node and Search Results Details Node.
          Note: Details may not be present in all groups.
        • <result> – Includes information about an individual result from a group. Results are delivered in the order they are to be displayed. See Result Node

Query Details Node

The query details describe the search query, including any spelling suggestions and if the query is of an adult nature.

Attribute Name Expected Value Description
input-query text The decoded query submitted in the API request.
anti-phrase text The base version of the query term (if available).
adult true/false Identifier that the query term may be of adult nature.
navigational true/false Deprecated feature, turned off by default.
marketingnavigational true/false Deprecated feature, turned off by default.
spelling-suggestion text If a recommendation exists, this parameter will provide an alternative query suggestion.

Example of XML result set for Query Details Node

This example includes the spelling-suggestion attribute. If there is no misspelled or unknown word this attribute will not appear in the return set.

<search-results search-type="by-relevance" version="7.0">
  <details>
    <input-query>wallett</input-query>
    <anti-phrase>wallett</anti-phrase>
    <adult>false</adult>
    <navigational>false</navigational>
    <marketingnavigational>false</marketingnavigational>
    <spelling-suggestion>wallet</spelling-suggestion>
  </details>
  ...

Result Count Details Node

The result count details describe a particular group of results (multiple groups may come back in a response).

Attribute Name Expected Value Description
group category web Indicates web result content.
images Indicates image result content.
news Indicates news result content.
video Indicates video result content.
related Indicates related search terms. ‘Type’ will equal ‘special’.
group category type main Indicates the primary results to display.
extra-cat Indicates paid results to display outside of the main results. ‘Type’ will equal ‘top’, ‘right’, or ‘bottom’.
paid-links Integer Number of paid results returned in the XML.
unpaid-links Integer Number of unpaid results returned in the XML.
max-count Integer Estimated total number of results available (only available if results set contains unpaid results).
Note: This number is subject to change on subsequent pages/queries.

The max-count attribute will match the results-count attribute when non-paid items are returned as part of the return set. If only paid results are returned the max-count attribute will return a value of 0.

Example of XML result set Result Count Details Node

This example shows a group category type of main:

<group type="main" group-by="relevance" category="web">
  <details>
    <paid-links>10</paid-links>
    <unpaid-links>10</unpaid-links>
    <max-count>25100000</max-count>
  </details>
  <results>
  ...

Note that the paid links count includes the links shown in the extra-cat sections (as well as any in the main section). The following shows the details section missing from the extra-cat nodes, as they go directly into results.

Also note the ‘group-by=”relevance”‘ entry. Return values are grouped by relevance, meaning those that are most relevant to the search are displayed first. For news items, they may be grouped by date instead of relevance. To change this behavior for news category queries, please talk to your Partnership Manager.

<group type="extra-cat" group-by="relevance" category="web" region="top">
  <result>
  ...
<group type="extra-cat" group-by="relevance" category="web" region="right">
  <result>

Search Results Details Node

The search results details how many and which results are included in the group, which assists with pagination and helping inform the end user about which results they’re looking at.

Attribute Name Expected Value Description
results-count Integer Estimated total number of results available (only available if results set contains unpaid results).
Note: This number is subject to change on subsequent pages/queries.
results-start Integer The absolute start position of the non-paid results for the page, equal to the ‘qi’ value submitted (defaults to 1 if the ‘qi’ value is not set).
results-end Integer The absolute position of the last result on the page.

Example of XML result set for Search Results Details Node

<details>
  <results-count>25100000</results-count>
  <results-start>1</results-start>
  <results-end>9</results-end>
</details>

Result Node

The result node contains the information needed to display the individual results.

Attribute Name Expected Value Description Category
content-source friendly-name Google Ads, Ads by Yahoo, etc… If enabled, the attribution of the engine that found the result. all categories
site-link URL The InfoSpace click URL to be used to link the title and display URL to the destination site. all categories
paid true/false Identifier if result is paid or nonpaid. all categories
display-url URL The URL to display beneath the search result description. all categories
title Text The title to display above the search result description. all categories
description Text The details to display beneath the result title. all categories
thumbnail-url URL The link to the image thumbnail. images
source-url URL The link to the webpage that displays the image. images, video
file-name Text The file name of the image. images
file-format File type The file type of the image. images, video
filesize Integer The file size of the image. images
filesize-units Unit type File size unit. images
height Integer Height of image in pixels. images
width Integer Width of image in pixels. images
thumbnail-height Integer Height of thumbnail image. images
thumbnail-width Integer Width of thumbnail image. images
video-duration Integer Duration of video file (in seconds). video
doc-channel Text Video site source (not available in all results). video
doc-alt-img URL Secondary thumbnail image to display (not available on all results). video
doc-img URL Primary thumbnail image to display. video
date Date/Time stamp Date/time stamp of result. news
source Text News source of result. news
epochseconds Integer Unix converted time stamp. news
deeplinks Node identifying additional results with an existing site web only

Example of XML result sets for Result Nodes

The first six attributes are common to all category types and should be displayed with all results. This shows and example of a web search for ‘Wallett’ (the same query that generated the spellsuggest attribute shown above):

<result>
    <content-sources>
        <content-source friendly-name="Yahoo! Search"/>
    </content-sources>
    <site-link>http://click.infospace.com/ClickHandler.ashx?du=http%3a%2f%2fwallett.com%2f&ru=http%3a%2f%2fwallett.com%2f&ld=20121004&ap=1&app=1&c=babylon2&s=babylon2&coi=239138&cop=main-title&euip=63.63.63.64&npp=1&p=0&pp=0&pvaid=fabbf0dba817424aa4f302c564ebac6c&ep=1&mid=9&hash=35422291FE4F269D72124BC616C65475</site-link>
    <paid>false</paid>
    <display-url>http://wallett.com/</display-url>
    <title>wallett.com: wallett cosmetics-Official Site</title>
    <description>wallett cosmetics-Official Site. Premium Cosmetics. Lipsticks, Lip-Pencils and Lip- Glosses.</description>
</result>

This example shows a sample result is for a search for images of ‘herbs’:

<result>
     <content-sources>
        <content-source friendly-name="Yahoo! Search" />
     </content-sources>
     <site-link>http://click.infospace.com/ClickHandler.ashx?du=http%3a%2f%2fthefreegeorge.com%2fthefreegeorge%2fwp-content%2fuploads%2f2011%2f02%2fGarden-Herbs.jpg&ru=http%3a%2f%2fthefreegeorge.com%2fthefreegeorge%2fwp-content%2fuploads%2f2011%2f02%2fGarden-Herbs.jpg&ld=20121004&ap=1&app=1&c=babylon2&s=babylon2&coi=372380&cop=main-title&euip=63.63.63.64&npp=1&p=0&pp=0&pvaid=a86f883eb16e4ba1a656130031ce7fbb&ep=1&mid=9&hash=B1E6822C30A804B1B1AEB38A69521413</site-link>
     <paid>false</paid>
     <display-url>http://thefreegeorge.com/thefreegeorge/wp-content/uploads/2011/02/Garden-Herbs.jpg</display-url>
     <thumbnail-url>http://ts4.mm.bing.net/images/thumbnail.aspx?q=4916866407597891&id=d2bdfc1439435e142b50800fb8ceb211</thumbnail-url>
     <source-url>http://thefreegeorge.com/thefreegeorge/herbs-garden-natural-pesticides/</source-url>
     <file-format>jpeg</file-format>
     <filesize>455.1</filesize>
     <filesize-units>KB</filesize-units>
     <height>1125</height>
     <width>1687</width>
     <thumbnail-height>106</thumbnail-height>
     <thumbnail-width>160</thumbnail-width>
 </result>

The following example result is for a video, the query term was ‘Oktoberfest’:

<result>
    <content-sources>
        <content-source friendly-name="Yahoo! Search" />
    </content-sources>
    <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?du=http%3a%2f%2fwn.com%2fSIEBEN_OKTOBERFEST_4&ru=http%3a%2f%2fwn.com%2fSIEBEN_OKTOBERFEST_4&ld=20121004&ap=14&app=1&c=magentic&s=magentic&coi=372376&cop=main-title&euip=10.10.10.10&npp=14&p=0&pp=0&pvaid=16b3177affd547d3ab009b659c103676&ep=14&mid=9&hash=22C2F2222FD08E784A32CFAF71D3B54A</site-link>
    <paid>false</paid>
    <display-url>http://wn.com/SIEBEN_OKTOBERFEST_4</display-url>
    <source-url>http://wn.com/SIEBEN_OKTOBERFEST_4</source-url>
    <file-name>http://wn.com/SIEBEN_OKTOBERFEST_4</file-name>
    <video-duration>9</video-duration>
    <title>Sieben Oktoberfest 4</title>
    <description>Future Perfect: Oktoberfest 4/7 (10.6.10 EP), Oktoberfest 2010 Munich-Costume parade-Christian Uhde 7:25-Horst Seehofer 9:03-Trachtenumzug-Teil 4, The Concord Singers ...</description>
    <doc-img>http://ts2.mm.bing.net/th?id=V.4623412788330609&pid=15.1</doc-img>
</result>

The following example is a news item returned in a query for ‘Oktoberfest’:

<result>
    <content-sources>
         <content-source friendly-name="Yahoo! News"/>
    </content-sources>
    <site-link>http://click.infospace.com/ClickHandler.ashx?du=http%3a%2f%2flacrossetribune.com%2fnews%2flocal%2f49195214-0ddc-11e2-a778-001a4bcf887a.html&ru=http%3a%2f%2flacrossetribune.com%2fnews%2flocal%2f49195214-0ddc-11e2-a778-001a4bcf887a.html&ld=20121004&ap=1&app=1&c=babylon2&s=babylon2&coi=372368&cop=main-title&euip=63.63.63.64&npp=1&p=0&pp=0&pvaid=b58e0af744d445298853fbddfc7bda1a&ep=1&mid=9&hash=1A034B027A26DFFB2B2D975A7DC09487</site-link>
    <paid>false</paid>
    <display-url>http://lacrossetribune.com/news/local/49195214-0ddc-11e2-a778-001a4bcf887a.html</display-url>
    <date>Wed Oct 03 22:00:00 PDT 2012</date>
    <source>La Crosse Tribune</source>
    <epochseconds>1349326800</epochseconds>
    <title>Oktoberfest clogs mobile networks</title>
    <description>Oktoberfest’s Torchlight Parade tonight could punch the lights out of some cellphones if the texting frenzy that KO’d a major network’s service during the Maple Leaf Parade is duplicated.</description>
 </result>

This example shows a web search for ‘boeing.com’ returning a paid result with deeplinks:

<result>
    <content-sources>
       <content-source friendly-name="Ads by Google"/>
    </content-sources>
    <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?du=www.indeed.com%2fBoeing&ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dCqcSPI_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUKGf0K0FYMkGiAEBoAHLxLLpA8gBAaoEHE_Q9zzMtB0SBYF9jrXdsSMmuDJWPBMGqxwirMA%26num%3d6%26sig%3dAOD64_3SZ8FiKJS5FJIdqwydbqBZCSF_ew%26adurl%3dhttp%3a%2f%2fwww.indeed.com%2fjobs%253Fq%253Dboeing%2526kw%253Dboeing%252Bcom%2526sid%253Dgoog61srchttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=245874&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=6&mid=9&hash=0CFC8A1EA8041EF6AFE7696FD9000D06</site-link>
    <paid>true</paid>
    <display-url>Sponsored By http://www.indeed.com/Boeing/</display-url>
    <title>Boeing Com</title>
    <description>Find all Boeing Com postings here, the most complete job site online.</description>
    <deeplinks>
      <result>
        <title>Search All Jobs</title>
        <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dCYPK_I_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUNOuoRxgyQaIAQGgAcvEsukDyAEBqgQcT9D3PMy0HRIFgX2Otd2xIya4MlY8EwarHCKswPoFCQgDEMHWpW8YAQ%26num%3d6%26ctype%3d4%26sig%3dAOD64_0QpPKlIYue6Vn6kKjT39GxU6Eiyg%26adurl%3dhttp%3a%2f%2fwww.indeed.com%2f%253Fkw%253Dboeing%252Bcom%2526sid%253Dgoog61srchttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=495&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=1&mid=9&hash=AE022526DA3521B7AADB08475BC763C7</site-link>
      </result>
      <result>
        <title>Post Your Resume</title>
        <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dC3WZfI_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUNDGk4AHYMkGiAEBoAHLxLLpA8gBAaoEHE_Q9zzMtB0SBYF9jrXdsSMmuDJWPBMGqxwirMD6BQkIAxDB1qVvGAI%26num%3d6%26ctype%3d4%26sig%3dAOD64_2T1lLhzzBmR1GS3R5ace0T6ScqlA%26adurl%3dhttp%3a%2f%2fwww.indeed.com%2fpromo%2fresume%253Fkw%253Dboeing%252Bcom%2526sid%253Dgoog61srchttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=495&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=2&mid=9&hash=CD1087330FF56DB329244C4514DFCE93</site-link>
      </result>
      <result>
         <title>Post a Job</title>
         <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dCRyTJI_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUN3Iu5MHYMkGiAEBoAHLxLLpA8gBAaoEHE_Q9zzMtB0SBYF9jrXdsSMmuDJWPBMGqxwirMD6BQkIAxDB1qVvGAM%26num%3d6%26ctype%3d4%26sig%3dAOD64_17etPaPEbQnq0OA_TBB1v0ZiAADg%26adurl%3dhttps%3a%2f%2fads.indeed.com%2fpromoredir%253Ftag%253Dpost-for-free%2526kw%253Dsitelink-haj%2526sid%253Dgoog61srchttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=495&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=3&mid=9&hash=2B3F554FFCC0368DC4C4322DBEA91950</site-link>
      </result>
    </deeplinks>
 </result>

This example shows a web search for ‘hotels‘ returning belly ads in the middle of non-paid results

<result>
            <site-link>
                http://ccs.demohostedclick.infospace.com/ClickHandler.ashx?encp=ld%3d20160824%26app%3d1%26c%3dsnapdotest2%26s%3dsnapdotest2%26rc%3dsnapdotest2%26dc%3d%26euip%3d67.63.63.64%26pvaid%3dbe1b669b3c7e4fc3af46b286abbfc161%26dt%3dDesktop%26fct.uid%3d3658f958b72c40c694d6bff6c4fbcabf%26en%3dyZ%252bM9KjE30mpbnuYn8ILQC1y%252fTLrkmfTv06JX%252fAdHQ3kDcW79W%252bb8g%253d%253d%26ru%3dhttps%253a%252f%252fwww.expedia.com%252fHotels%26ap%3d3%26coi%3d1494%26npp%3d3%26p%3d0%26pp%3d0%26mid%3d9%26ep%3d3%26du%3dhttps%253a%252f%252fwww.expedia.com%252fHotels%26hash%3d45890FC4A55FFCC266D4CB170EBA408F&cop=main-title
            </site-link>
            <paid>false</paid>
            <display-url>https://www.expedia.com/Hotels</display-url>
            <title>
                <strong>Hotels</strong>: Find Cheap <strong>Hotel</strong> Deals, Discounts, & Reservations ...
            </title>
            <description>
                Cheap <strong>Hotel</strong> Deals - Discover great <strong>hotel</strong> prices while planning the right reservations at the best resorts, even if you need last minute rates.
            </description>
        </result>
        <result>
            <site-link>
                http://ccs.demohostedclick.infospace.com/ClickHandler.ashx?encp=ld%3d20160824%26app%3d1%26c%3dsnapdotest2%26s%3dsnapdotest2%26rc%3dsnapdotest2%26dc%3d%26euip%3d67.63.63.64%26pvaid%3dbe1b669b3c7e4fc3af46b286abbfc161%26dt%3dDesktop%26fct.uid%3d3658f958b72c40c694d6bff6c4fbcabf%26en%3dyZ%252bM9KjE30mpbnuYn8ILQC1y%252fTLrkmfTv06JX%252fAdHQ3kDcW79W%252bb8g%253d%253d%26ru%3dhttp%253a%252f%252f0.r.msn.com%252f%253fld%253dd3_Vjf4gc5N9E-FbnE2YV9VjVUCUw49xK8-9PeA2s5yq5xsFzcCtLm7SuuflahNmBw8jUwnHZgFU4JC4UPs7WpzoNSWAInXOzF2YUxmtpMBdrPI1aNfOSN6fau7avOaniJVjcKWJvoDphMQHUCf6Nb0HmkXYo%2526u%253dhttp%25253a%25252f%25252fwww.agoda.com%25252fpartners%25252ftracking.aspx%25253ftype%25253d1%252526site_id%25253d1744576%252526url%25253dhttp%25253a%25252f%25252fwww.agoda.com%25252f%252526tag%25253db1daede7-a876-523f-84ed-e8af8d846c83%252526device%25253dc%252526network%25253ds%252526adid%25253d%25257bcreative%25257d%252526rand%25253d%25257brandom%25257d%252526expid%25253d%25257baceid%25257d%252526adpos%25253d%25257badposition%25257d%252526utm_source%25253dbing%252526utm_medium%25253dcpc%252526utm_campaign%25253dIntent%25252520Engine%25252520-%25252520161%252526utm_term%25253dhotel%252526utm_content%25253dat%2525253Ahotel%2525257Cgt%2525253Aexact%26ap%3d4%26coi%3d1493%26npp%3d0%26p%3d1%26pp%3d1%26mid%3d9%26ep%3d7%26du%3dAgoda.com%252f_Hotels%26hash%3d2BC96080FCDABA373F7173F1F8A13874&cop=main-title
            </site-link>
            <paid>true</paid>
            <display-url>http://Agoda.com/_Hotels</display-url>
            <title>Top <strong>Hotels</strong> | Agoda.com</title>
            <description>
                Find Great <strong>Hotel</strong> Deals Book Now with Agoda!
            </description>
            <seller-ratings-advertiser-info>agoda.com</seller-ratings-advertiser-info>
            <seller-ratings-rating>4.5</seller-ratings-rating>
            <seller-ratings-review-count>102680</seller-ratings-review-count>
            <seller-ratings-source-url>
                https://www.bing.com/merchant/reviews?mid=agoda.com&FORM=MRANNO
            </seller-ratings-source-url>
        </result>
        <result>
            <site-link>
                http://ccs.demohostedclick.infospace.com/ClickHandler.ashx?encp=ld%3d20160824%26app%3d1%26c%3dsnapdotest2%26s%3dsnapdotest2%26rc%3dsnapdotest2%26dc%3d%26euip%3d67.63.63.64%26pvaid%3dbe1b669b3c7e4fc3af46b286abbfc161%26dt%3dDesktop%26fct.uid%3d3658f958b72c40c694d6bff6c4fbcabf%26en%3dyZ%252bM9KjE30mpbnuYn8ILQC1y%252fTLrkmfTv06JX%252fAdHQ3kDcW79W%252bb8g%253d%253d%26ru%3dhttp%253a%252f%252f2359738.r.msn.com%252f%253fld%253dd3n7O0bibY9_6SIg8sKrkqaDVUCUwDECt0bRzHIf8k34t1mB68-2Nz3TDBzjpI1agyJTaRBpeCr-YZjWHKtn-QXhCTGO5PXoVoyzToYz9aVDkMLwFATM7vRfPCtLBNgjdhreFwxKnTRos_laogxPQLYY1chQ0%2526u%253dhttp%25253a%25252f%25252f1195.xg4ken.com%25252fmedia%25252fredir.php%25253fprof%25253d103%252526camp%25253d174830%252526affcode%25253dkw26422%252526k_inner_url_encoded%25253d0%252526cid%25253d2936403068%252526queryStr%25253dhotels%252526kdv%25253dc%252526url%25255b%25255d%25253dhttps%25253a%25252f%25252fwww.orbitz.com%25252fhotels%25253fsemcid%25253dorbitz-us.ub.bing.search.hotel%252526kword%25253dbe.%25257chotels%25257c.103.174830.419.26422.2936403068%252526epi%25253d_kenshoo_clickid_%252526utm_source%25253dbing%252526utm_medium%25253dcpc%252526utm_campaign%25253dGeneric%2525253AHot%2525253A%25252522Hotels%25252522%252526utm_term%25253dhotels%252526utm_content%25253dGeneric%2525253AHot%2525253A%25252522Hotels%25252522%26ap%3d5%26coi%3d1493%26npp%3d0%26p%3d1%26pp%3d2%26mid%3d9%26ep%3d8%26du%3dwww.ORBITZ.com%252fHotels%26hash%3d6C09771B7383B87270346CF8D7365AF3&cop=main-title
            </site-link>
            <paid>true</paid>
            <display-url>http://www.ORBITZ.com/Hotels</display-url>
            <title>
                ORBITZ - <strong>Hotels</strong> - Search Thousands of Popular <strong>Hotels</strong> Worldwide.
            </title>
            <description>
                Search Thousands of Popular <strong>Hotels</strong> Worldwide. Low Price Guarantee!
            </description>
            <seller-ratings-advertiser-info>orbitz.com</seller-ratings-advertiser-info>
            <seller-ratings-rating>4</seller-ratings-rating>
            <seller-ratings-review-count>70607</seller-ratings-review-count>
            <seller-ratings-source-url>
                https://www.bing.com/merchant/reviews?mid=orbitz.com&FORM=MRANNO
            </seller-ratings-source-url>
        </result>
        <result>
            <site-link>
                http://ccs.demohostedclick.infospace.com/ClickHandler.ashx?encp=ld%3d20160824%26app%3d1%26c%3dsnapdotest2%26s%3dsnapdotest2%26rc%3dsnapdotest2%26dc%3d%26euip%3d67.63.63.64%26pvaid%3dbe1b669b3c7e4fc3af46b286abbfc161%26dt%3dDesktop%26fct.uid%3d3658f958b72c40c694d6bff6c4fbcabf%26en%3dyZ%252bM9KjE30mpbnuYn8ILQC1y%252fTLrkmfTv06JX%252fAdHQ3kDcW79W%252bb8g%253d%253d%26ru%3dhttps%253a%252f%252fwww.travelocity.com%252fHotels%26ap%3d6%26coi%3d1494%26npp%3d4%26p%3d0%26pp%3d0%26mid%3d9%26ep%3d4%26du%3dhttps%253a%252f%252fwww.travelocity.com%252fHotels%26hash%3d51D85C33AC314F4A5BC1E48FA47D6613&cop=main-title
            </site-link>
            <paid>false</paid>
            <display-url>https://www.travelocity.com/Hotels</display-url>
            <title>
                Cheap <strong>Hotels</strong>: Book <strong>Hotel</strong> Deals With Our <strong>Hotel</strong> Finder ...
            </title>
            <description>
                Use Travelocity to book your next <strong>hotel</strong> to find the best prices guaranteed. Search <strong>hotel</strong> deals, read reviews and Wander Wisely!
            </description>
        </result>
        <result>

Error Messages

The InfoSpace XML API returns descriptive error messages to provide status and to help troubleshoot invalid API calls. Each error message is returned as a standard XML response. Within <search-results> collection, the error description parameter contains the error message.

Error responses will return in the following format:

<?xml version="1.0" encoding="utf-8" ?>
<search-results version="7.0">
  <error description="[error message]" />
</search-results>
...

The following table is a list of Metasearch error messages.

Error Message Description
‘Cobrand name not specified’ A valid CoBrand ID was not passed in the URL.
‘Empty query’ No query was passed in the API call.
‘No results found’ The API did not return any search results for the user’s query.
‘Invalid IP address in request’ The request did not contain a valid user IP in the user header.
‘User-agent not passed as part of user headers’ The request did not contain a valid user-agent in the user header.
‘Invalid Category.’ The API call requested a vertical category that does not exist.

Next: Search Engine Results Page (SERP) Layout
Back to: Querying for Content