<wadl:application xmlns:wadl="http://research.sun.com/wadl/2006/10" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <wadl:doc xmlns:enunciate="http://enunciate.codehaus.org/" enunciate:generatedBy="Enunciate-1.24"/>
  <wadl:grammars>
    <wadl:include href="ns0.xsd"/>
  </wadl:grammars>
  <wadl:resources base="http://api.realtybaron.com/answers">
    <wadl:resource path="/rest/answers/find">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions by location.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="tag" style="query">
            <wadl:doc>
              <![CDATA[List of tags]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="order" style="query">
            <wadl:doc>
              <![CDATA[The order in which answers are returned.  Possible values include: <em>revenue</em> (default), <em>ranking</em>, <em>rating</em>, <em>recent</em>, <em>oldest</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="payload" style="query">
            <wadl:doc>
              <![CDATA[The type of content returned.  Possible values include <em>xml</em> (default) or <em>html</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="user_agent" style="query">
            <wadl:doc>
              <![CDATA[The user agent string of the client originating the request.  For web browsers, the user agent can be obtained from the "User-Agent" header.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="ip_address" style="query">
            <wadl:doc>
              <![CDATA[The IP address of the client originating the request.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="profile_url" style="query">
            <wadl:doc>
              <![CDATA[The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the agent's unique identifer and embed the resulting URL in answer badges whose links are not enhanced with advertising.  For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=joerealtor. See http://www.agentrank.com/api/rest.profile.view.username.html for documentation on the profile service endpoint.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/answers/find">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions by location.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="tag" style="query">
            <wadl:doc>
              <![CDATA[List of tags]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="order" style="query">
            <wadl:doc>
              <![CDATA[The order in which answers are returned.  Possible values include: <em>revenue</em> (default), <em>ranking</em>, <em>rating</em>, <em>recent</em>, <em>oldest</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="payload" style="query">
            <wadl:doc>
              <![CDATA[The type of content returned.  Possible values include <em>xml</em> (default) or <em>html</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="user_agent" style="query">
            <wadl:doc>
              <![CDATA[The user agent string of the client originating the request.  For web browsers, the user agent can be obtained from the "User-Agent" header.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="ip_address" style="query">
            <wadl:doc>
              <![CDATA[The IP address of the client originating the request.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="profile_url" style="query">
            <wadl:doc>
              <![CDATA[The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the agent's unique identifer and embed the resulting URL in answer badges whose links are not enhanced with advertising.  For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=joerealtor. See http://www.agentrank.com/api/rest.profile.view.username.html for documentation on the profile service endpoint.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/answers/find">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions by location.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="tag" style="query">
            <wadl:doc>
              <![CDATA[List of tags]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="order" style="query">
            <wadl:doc>
              <![CDATA[The order in which answers are returned.  Possible values include: <em>revenue</em> (default), <em>ranking</em>, <em>rating</em>, <em>recent</em>, <em>oldest</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="payload" style="query">
            <wadl:doc>
              <![CDATA[The type of content returned.  Possible values include <em>xml</em> (default) or <em>html</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="user_agent" style="query">
            <wadl:doc>
              <![CDATA[The user agent string of the client originating the request.  For web browsers, the user agent can be obtained from the "User-Agent" header.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="ip_address" style="query">
            <wadl:doc>
              <![CDATA[The IP address of the client originating the request.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="profile_url" style="query">
            <wadl:doc>
              <![CDATA[The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the agent's unique identifer and embed the resulting URL in answer badges whose links are not enhanced with advertising.  For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=joerealtor. See http://www.agentrank.com/api/rest.profile.view.username.html for documentation on the profile service endpoint.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/questions/monitor">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Monitor the approval status and answer count of one or more questions]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[count total count]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/questions/monitor">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Monitor the approval status and answer count of one or more questions]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[count total count]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/questions/monitor">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Monitor the approval status and answer count of one or more questions]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[count total count]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/answers/count/since">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Count the total number of answers by status]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="since" style="query">
            <wadl:doc>
              <![CDATA[a date from which new answers will be counted]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/answers/count/since">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Count the total number of answers by status]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="since" style="query">
            <wadl:doc>
              <![CDATA[a date from which new answers will be counted]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/answers/count/since">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Count the total number of answers by status]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="since" style="query">
            <wadl:doc>
              <![CDATA[a date from which new answers will be counted]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/answers/count/total">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Count the total number of answers by status]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/answers/count/total">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Count the total number of answers by status]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/answers/count/total">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Count the total number of answers by status]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="id" style="query">
            <wadl:doc>
              <![CDATA[set of unique question IDs]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/answers/get/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[The question's unique identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Fetch a question's answers.  Answers are moderated.  This method returns those answers which have been approved.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="order" style="query">
            <wadl:doc>
              <![CDATA[The order in which answers are returned.  Possible values include: <em>revenue</em> (default), <em>ranking</em>, <em>rating</em>, <em>recent</em>, <em>oldest</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="payload" style="query">
            <wadl:doc>
              <![CDATA[The type of content returned.  Possible values include <em>xml</em> (default) or <em>html</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="user_agent" style="query">
            <wadl:doc>
              <![CDATA[The user agent string of the client originating the request.  For web browsers, the user agent can be obtained from the "User-Agent" header.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="ip_address" style="query">
            <wadl:doc>
              <![CDATA[The IP address of the client originating the request.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="profile_url" style="query">
            <wadl:doc>
              <![CDATA[The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the agent's unique identifer and embed the resulting URL in answer badges whose links are not enhanced with advertising.  For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=joerealtor. See http://www.agentrank.com/api/rest.profile.view.username.html for documentation on the profile service endpoint.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/answers/get/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[The question's unique identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Fetch a question's answers.  Answers are moderated.  This method returns those answers which have been approved.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="order" style="query">
            <wadl:doc>
              <![CDATA[The order in which answers are returned.  Possible values include: <em>revenue</em> (default), <em>ranking</em>, <em>rating</em>, <em>recent</em>, <em>oldest</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="payload" style="query">
            <wadl:doc>
              <![CDATA[The type of content returned.  Possible values include <em>xml</em> (default) or <em>html</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="user_agent" style="query">
            <wadl:doc>
              <![CDATA[The user agent string of the client originating the request.  For web browsers, the user agent can be obtained from the "User-Agent" header.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="ip_address" style="query">
            <wadl:doc>
              <![CDATA[The IP address of the client originating the request.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="profile_url" style="query">
            <wadl:doc>
              <![CDATA[The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the agent's unique identifer and embed the resulting URL in answer badges whose links are not enhanced with advertising.  For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=joerealtor. See http://www.agentrank.com/api/rest.profile.view.username.html for documentation on the profile service endpoint.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/answers/get/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[The question's unique identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Fetch a question's answers.  Answers are moderated.  This method returns those answers which have been approved.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="order" style="query">
            <wadl:doc>
              <![CDATA[The order in which answers are returned.  Possible values include: <em>revenue</em> (default), <em>ranking</em>, <em>rating</em>, <em>recent</em>, <em>oldest</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="payload" style="query">
            <wadl:doc>
              <![CDATA[The type of content returned.  Possible values include <em>xml</em> (default) or <em>html</em>.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="user_agent" style="query">
            <wadl:doc>
              <![CDATA[The user agent string of the client originating the request.  For web browsers, the user agent can be obtained from the "User-Agent" header.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="ip_address" style="query">
            <wadl:doc>
              <![CDATA[The IP address of the client originating the request.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="profile_url" style="query">
            <wadl:doc>
              <![CDATA[The location on your website where profiles can be viewed. We'll replace the variable "{0}" with the agent's unique identifer and embed the resulting URL in answer badges whose links are not enhanced with advertising.  For example, http://www.yourwebsite.com/profile?profile={0} will send user to http://www.yourwebsite.com/profile?profile=joerealtor. See http://www.agentrank.com/api/rest.profile.view.username.html for documentation on the profile service endpoint.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/location/find/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how 'location' is interpreted --- <em>metro</em>, <em>city</em>, <em>zipcode</em>, or <em>address</em>]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find available locations by context.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="location" style="query">
            <wadl:doc>
              <![CDATA[A free-text value representing a (partial) location name. Almost any property, ZIP, city, or metro specification will work, e.g "2407 Euclid Avenue", "Austin, TX  78704", "78704", "Austin, TX", "Austin-San Marcos".]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of location values]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/location/find/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how 'location' is interpreted --- <em>metro</em>, <em>city</em>, <em>zipcode</em>, or <em>address</em>]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find available locations by context.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="location" style="query">
            <wadl:doc>
              <![CDATA[A free-text value representing a (partial) location name. Almost any property, ZIP, city, or metro specification will work, e.g "2407 Euclid Avenue", "Austin, TX  78704", "78704", "Austin, TX", "Austin-San Marcos".]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of location values]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/location/find/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how 'location' is interpreted --- <em>metro</em>, <em>city</em>, <em>zipcode</em>, or <em>address</em>]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find available locations by context.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="location" style="query">
            <wadl:doc>
              <![CDATA[A free-text value representing a (partial) location name. Almost any property, ZIP, city, or metro specification will work, e.g "2407 Euclid Avenue", "Austin, TX  78704", "78704", "Austin, TX", "Austin-San Marcos".]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of location values]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/question/append/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's secret identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/question/append/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's secret identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/question/append/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's secret identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/question/edit/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's secret identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find a question using its secret identifier.  Secret identifiers are private.  Therefore, this method should only used when the inquirer is editing a question.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/question/edit/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's secret identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find a question using its secret identifier.  Secret identifiers are private.  Therefore, this method should only used when the inquirer is editing a question.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/question/edit/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's secret identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find a question using its secret identifier.  Secret identifiers are private.  Therefore, this method should only used when the inquirer is editing a question.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/question/post/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how 'location' is interpreted --- <em>metro</em>, <em>city</em>, <em>zipcode</em>,  <em>address</em>, or <em>listing</em>.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:doc>
          <![CDATA[Post a new question for real estate agents to answer.]]>
        </wadl:doc>
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/question/post/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how 'location' is interpreted --- <em>metro</em>, <em>city</em>, <em>zipcode</em>,  <em>address</em>, or <em>listing</em>.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:doc>
          <![CDATA[Post a new question for real estate agents to answer.]]>
        </wadl:doc>
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/question/post/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how 'location' is interpreted --- <em>metro</em>, <em>city</em>, <em>zipcode</em>,  <em>address</em>, or <em>listing</em>.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:doc>
          <![CDATA[Post a new question for real estate agents to answer.]]>
        </wadl:doc>
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/question/view/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's unique identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Get a question using its unique identifier.  Unique identifiers are public.  Therefore, this method should be used when anyone is viewing a question.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/question/view/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's unique identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Get a question using its unique identifier.  Unique identifiers are public.  Therefore, this method should be used when anyone is viewing a question.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/question/view/{id}">
      <wadl:param name="id" style="path">
        <wadl:doc>
          <![CDATA[a question's unique identifier]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Get a question using its unique identifier.  Unique identifiers are public.  Therefore, this method should be used when anyone is viewing a question.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/questions/find/returns">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions intended for the publishing website.  If we identify a question whose author obviously intended to contact a publisher's website directly, we'll mark the question as 'return to
sender'.  Your website can periodically fetch the question content and contact information of the inquirer using this service endpoint.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="start_index" style="query">
            <wadl:doc>
              <![CDATA[The page on which the query will start. Zero-based index. Defaults to 0.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="max_results" style="query">
            <wadl:doc>
              <![CDATA[The size of result set.  The number of elements returned by the query.  Defaults to 10 results.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="past_hours" style="query">
            <wadl:doc>
              <![CDATA[The number of hours to look back in the past for returned questions.  Defaults to 24 hours.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/questions/find/returns">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions intended for the publishing website.  If we identify a question whose author obviously intended to contact a publisher's website directly, we'll mark the question as 'return to
sender'.  Your website can periodically fetch the question content and contact information of the inquirer using this service endpoint.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="start_index" style="query">
            <wadl:doc>
              <![CDATA[The page on which the query will start. Zero-based index. Defaults to 0.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="max_results" style="query">
            <wadl:doc>
              <![CDATA[The size of result set.  The number of elements returned by the query.  Defaults to 10 results.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="past_hours" style="query">
            <wadl:doc>
              <![CDATA[The number of hours to look back in the past for returned questions.  Defaults to 24 hours.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/questions/find/returns">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions intended for the publishing website.  If we identify a question whose author obviously intended to contact a publisher's website directly, we'll mark the question as 'return to
sender'.  Your website can periodically fetch the question content and contact information of the inquirer using this service endpoint.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="start_index" style="query">
            <wadl:doc>
              <![CDATA[The page on which the query will start. Zero-based index. Defaults to 0.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="max_results" style="query">
            <wadl:doc>
              <![CDATA[The size of result set.  The number of elements returned by the query.  Defaults to 10 results.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="past_hours" style="query">
            <wadl:doc>
              <![CDATA[The number of hours to look back in the past for returned questions.  Defaults to 24 hours.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/questions/find/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how <em>location</em> parameter is interpreted -- <em>state</em>, <em>metro</em>, <em>city</em>, <em>zipcode</em>, or <em>address</em>, or <em>listing</em>.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions by location.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="location" style="query">
            <wadl:doc>
              <![CDATA[A free-text value representing the location near which you'd like to search for questions.  Almost any state, metro, city, ZIP, or property address will work, e.g. "Texas", "Austin-San Marcos", "Austin, TX", "78704", or "2407 Euclid Avenue".  Alternatively, send us a latitude and longitude.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="latitude" style="query">
            <wadl:doc>
              <![CDATA[A decimal value representing the geographical latitude.  Required if location is empty.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="longitude" style="query">
            <wadl:doc>
              <![CDATA[A decimal value representing the geographical longitude.  Required if location is empty.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="start_index" style="query">
            <wadl:doc>
              <![CDATA[The page on which the query will start. Zero-based index. Defaults to 0.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="max_results" style="query">
            <wadl:doc>
              <![CDATA[The size of result set.  The number of elements returned by the query.  Defaults to 10 results.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="tag" style="query">
            <wadl:doc>
              <![CDATA[List of tags]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="view_url" style="query">
            <wadl:doc>
              <![CDATA[the location on your website where answers to a question can be viewed. We'll replace the variable "{0}" with a question's unique ID and embed the resulting URL in the JavaScript used to render a map. For example, http://www.yourwebsite.com/answers?question={0} will send user to http://www.yourwebsite.com/answers?question=1.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/questions/find/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how <em>location</em> parameter is interpreted -- <em>state</em>, <em>metro</em>, <em>city</em>, <em>zipcode</em>, or <em>address</em>, or <em>listing</em>.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions by location.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="location" style="query">
            <wadl:doc>
              <![CDATA[A free-text value representing the location near which you'd like to search for questions.  Almost any state, metro, city, ZIP, or property address will work, e.g. "Texas", "Austin-San Marcos", "Austin, TX", "78704", or "2407 Euclid Avenue".  Alternatively, send us a latitude and longitude.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="latitude" style="query">
            <wadl:doc>
              <![CDATA[A decimal value representing the geographical latitude.  Required if location is empty.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="longitude" style="query">
            <wadl:doc>
              <![CDATA[A decimal value representing the geographical longitude.  Required if location is empty.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="start_index" style="query">
            <wadl:doc>
              <![CDATA[The page on which the query will start. Zero-based index. Defaults to 0.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="max_results" style="query">
            <wadl:doc>
              <![CDATA[The size of result set.  The number of elements returned by the query.  Defaults to 10 results.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="tag" style="query">
            <wadl:doc>
              <![CDATA[List of tags]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="view_url" style="query">
            <wadl:doc>
              <![CDATA[the location on your website where answers to a question can be viewed. We'll replace the variable "{0}" with a question's unique ID and embed the resulting URL in the JavaScript used to render a map. For example, http://www.yourwebsite.com/answers?question={0} will send user to http://www.yourwebsite.com/answers?question=1.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/questions/find/{context}">
      <wadl:param name="context" style="path">
        <wadl:doc>
          <![CDATA[A context type which determines how <em>location</em> parameter is interpreted -- <em>state</em>, <em>metro</em>, <em>city</em>, <em>zipcode</em>, or <em>address</em>, or <em>listing</em>.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Find questions by location.]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="location" style="query">
            <wadl:doc>
              <![CDATA[A free-text value representing the location near which you'd like to search for questions.  Almost any state, metro, city, ZIP, or property address will work, e.g. "Texas", "Austin-San Marcos", "Austin, TX", "78704", or "2407 Euclid Avenue".  Alternatively, send us a latitude and longitude.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="latitude" style="query">
            <wadl:doc>
              <![CDATA[A decimal value representing the geographical latitude.  Required if location is empty.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="longitude" style="query">
            <wadl:doc>
              <![CDATA[A decimal value representing the geographical longitude.  Required if location is empty.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="start_index" style="query">
            <wadl:doc>
              <![CDATA[The page on which the query will start. Zero-based index. Defaults to 0.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="max_results" style="query">
            <wadl:doc>
              <![CDATA[The size of result set.  The number of elements returned by the query.  Defaults to 10 results.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="tag" style="query">
            <wadl:doc>
              <![CDATA[List of tags]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="view_url" style="query">
            <wadl:doc>
              <![CDATA[the location on your website where answers to a question can be viewed. We'll replace the variable "{0}" with a question's unique ID and embed the resulting URL in the JavaScript used to render a map. For example, http://www.yourwebsite.com/answers?question={0} will send user to http://www.yourwebsite.com/answers?question=1.]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[This identifies your application.  Please visit <a href="http://www.realtybaron.com/publisher">realtybaron.com/publisher</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[list of questions]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/user/add/{role}">
      <wadl:param name="role" style="path">
        <wadl:doc>
          <![CDATA[The primary role of new user -- <em>AGENT</em> or <em>PARTNER</em>. Currently, any real estate professional is considered an <em>AGENT</em>.  <em>PARTNER</em> is reserved for non-licensed web publishers.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:doc>
          <![CDATA[Add a new user account]]>
        </wadl:doc>
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[new user]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/user/add/{role}">
      <wadl:param name="role" style="path">
        <wadl:doc>
          <![CDATA[The primary role of new user -- <em>AGENT</em> or <em>PARTNER</em>. Currently, any real estate professional is considered an <em>AGENT</em>.  <em>PARTNER</em> is reserved for non-licensed web publishers.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:doc>
          <![CDATA[Add a new user account]]>
        </wadl:doc>
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[new user]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/user/add/{role}">
      <wadl:param name="role" style="path">
        <wadl:doc>
          <![CDATA[The primary role of new user -- <em>AGENT</em> or <em>PARTNER</em>. Currently, any real estate professional is considered an <em>AGENT</em>.  <em>PARTNER</em> is reserved for non-licensed web publishers.]]>
        </wadl:doc>
      </wadl:param>
      <wadl:method name="POST">
        <wadl:doc>
          <![CDATA[Add a new user account]]>
        </wadl:doc>
        <wadl:request/>
        <wadl:response>
          <wadl:doc>
            <![CDATA[new user]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/rest/user/get/credentials">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Request a user's credentials be emailed]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="email" style="query">
            <wadl:doc>
              <![CDATA[user's email address]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please email <a href="mailto:help@realtybaron.com">help@realtybaron.com</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="*/*" element="response"/>
          <wadl:representation mediaType="application/xml" element="response"/>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/xml/user/get/credentials">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Request a user's credentials be emailed]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="email" style="query">
            <wadl:doc>
              <![CDATA[user's email address]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please email <a href="mailto:help@realtybaron.com">help@realtybaron.com</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/xml" element="response"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
    <wadl:resource path="/json/user/get/credentials">
      <wadl:method name="GET">
        <wadl:doc>
          <![CDATA[Request a user's credentials be emailed]]>
        </wadl:doc>
        <wadl:request>
          <wadl:param name="email" style="query">
            <wadl:doc>
              <![CDATA[user's email address]]>
            </wadl:doc>
          </wadl:param>
          <wadl:param name="api_key" style="query">
            <wadl:doc>
              <![CDATA[API key.  This identifies your application.  Please email <a href="mailto:help@realtybaron.com">help@realtybaron.com</a> to request an API key.]]>
            </wadl:doc>
          </wadl:param>
        </wadl:request>
        <wadl:response>
          <wadl:doc>
            <![CDATA[api response]]>
          </wadl:doc>
          <wadl:representation mediaType="application/json"/>
        </wadl:response>
      </wadl:method>
    </wadl:resource>
  </wadl:resources>
</wadl:application>

