Boatinho XML Feed Format

Overview

Provide a UTF-8 encoded XML feed at a stable HTTPS URL. Each listing must contain core details, at least one image, an ISO-8601 <updated_at>, and a valid <status>. We refresh regularly.

Template

<?xml version="1.0" encoding="UTF-8"?>
<boatinhoFeed xmlns="https://www.boatinho.com/feed" version="1.0" generated_at="2025-08-29T12:00:00Z">
  <dealer>
    <name>Your Dealer Name</name>
    <website>https://www.yourdealer.com</website>
    <contact_email>[email protected]</contact_email>
    <contact_phone>+1-555-0100</contact_phone>
  </dealer>

  <listings>
    <listing>
      <title>Year Make Model</title>
      <url>https://www.yourdealer.com/listing/12345</url>
      <price currency="USD">12345</price>
      <condition>used</condition>
      <class>ClassName</class>
      <make>Make</make>
      <model>Model</model>
      <year>2021</year>
      <length unit="ft">24.0</length>
      <location>
        <city>City</city>
        <state>ST</state>
        <country>US</country>
      </location>
      <images>
        <image primary="true">https://cdn.yourdealer.com/img/1.jpg</image>
      </images>
      <status>available</status>
      <updated_at>2025-08-28T22:41:00Z</updated_at>
      <description><![CDATA[ Plain text or safely sanitized content. ]]></description>

      <stock_number>OPTIONAL</stock_number>
      <vin_hin>OPTIONAL</vin_hin>
      <hours>OPTIONAL</hours>
      <engine>
        <type>OPTIONAL</type>
        <hp>OPTIONAL</hp>
        <fuel>OPTIONAL</fuel>
      </engine>
      <hull_material>OPTIONAL</hull_material>
    </listing>
  </listings>
</boatinhoFeed>

Example (Multiple Listings)

<?xml version="1.0" encoding="UTF-8"?>
<boatinhoFeed xmlns="https://www.boatinho.com/feed" version="1.0" generated_at="2025-08-29T12:00:00Z">
  <dealer>
    <name>Harbor Boats Inc.</name>
    <website>https://www.harborboats.example</website>
    <contact_email>[email protected]</contact_email>
    <contact_phone>+1-555-0150</contact_phone>
  </dealer>

  <listings>
    <listing>
      <title>2021 Boston Whaler 170 Montauk</title>
      <url>https://www.harborboats.example/boats/HB-77201</url>
      <price currency="USD">37995</price>
      <condition>used</condition>
      <class>Center Console</class>
      <make>Boston Whaler</make>
      <model>170 Montauk</model>
      <year>2021</year>
      <length unit="ft">17.0</length>
      <location><city>Miami</city><state>FL</state><country>US</country></location>
      <images>
        <image primary="true">https://cdn.harborboats.example/77201/1.jpg</image>
        <image>https://cdn.harborboats.example/77201/2.jpg</image>
      </images>
      <status>available</status>
      <updated_at>2025-08-28T19:20:00Z</updated_at>
      <description><![CDATA[ Clean boat, service records available, bimini top. ]]></description>
      <stock_number>HB-170M-21</stock_number>
      <engine><type>Outboard</type><hp>90</hp><fuel>Gasoline</fuel></engine>
      <hull_material>Fiberglass</hull_material>
    </listing>

    <listing>
      <title>2024 Beneteau Oceanis 40.1</title>
      <url>https://www.harborboats.example/boats/HB-88002</url>
      <price currency="USD">329000</price>
      <condition>new</condition>
      <class>Sail</class>
      <make>Beneteau</make>
      <model>Oceanis 40.1</model>
      <year>2024</year>
      <length unit="ft">42.3</length>
      <location><city>San Diego</city><state>CA</state><country>US</country></location>
      <images><image primary="true">https://cdn.harborboats.example/88002/1.jpg</image></images>
      <status>available</status>
      <updated_at>2025-08-28T19:30:00Z</updated_at>
      <description><![CDATA[ In-stock. Factory warranty. Delivery options available. ]]></description>
      <stock_number>HB-O401-24</stock_number>
      <engine><type>Inboard Diesel</type><hp>45</hp><fuel>Diesel</fuel></engine>
      <hull_material>Fiberglass</hull_material>
    </listing>
  </listings>
</boatinhoFeed>

Requirements & Best Practices

• UTF-8 XML, publicly reachable over HTTPS.
• Keep <updated_at> accurate (UTC ISO-8601).
• Provide at least one image (absolute URL). Mark primary image when possible.
• Use <status>: available, sold, or pending. Remove sold ASAP.
• Numeric <price>; set currency via attribute, e.g. currency="USD".
• Prefer plain text or CDATA for <description>; strip unsafe HTML.