Integrate an XML file

If you’re in real estate, you can connect your XML feed to Marq. Contact your CSM to start the process for enabling your account for an XML feed.

If you use XML, you will need to host an XML document on a public URL and paste the URL into Marq. The XML document needs to be in accordance with the 2017 Zillow Interchange Format. If you would like to see a sample XML file, click here.

Set up

Connect your XML to Marq.

Navigate to the Marq home page. Click the “Data Automation” tab in the left panel. A window will open. Under the correct dataset, add a title to your data source. Make sure XML is selected from the drop-down.
Paste the URL from your XML document and click “Connect!”.

Note: You will need to add the "License Number" node as a subnode to the "Agent" node. See example below:

<Agent>
 <FirstName>Alan</FirstName>
 <LastName>Smith</LastName>
 <EmailAddress>alan.smith@brokersite.com</EmailAddress>
 <PictureUrl>http://BrokerSite.com/alanpic.jpg</PictureUrl>
 <OfficeLineNumber>206-555-1212</OfficeLineNumber>
 <MobilePhoneLineNumber>206-888-1234</MobilePhoneLineNumber>
 <FaxLineNumber>206-555-1233</FaxLineNumber>
 <LicenseNumber>123456789</LicenseNumber>
</Agent>

Example XML file

When building out your XML file, be sure it follows in accordance with the 2017 Zillow Interchange Format. Below is a sample XML file.

<?xml version='1.0'?>
<Listings>
    <Listing>
        <Location>
            <Suburb>Brookhurst</Suburb>
			<StreetAddress>520 Setliff</StreetAddress>
            <UnitNumber>75</UnitNumber>
            <City>Adrian</City>
            <State>MN</State>
            <Zip>75904</Zip>
        </Location>
        <ListingDetails>
            <Status>Pending</Status>
            <Price>14900</Price>
			<ListingUrl>http://website.com</ListingUrl>
            <MlsId>54628</MlsId>
			<ProviderListingId>23926</ProviderListingId>
            <VirtualTourUrl>http://website.com</VirtualTourUrl>
			<GSTInclusive>textvalue here</GSTInclusive>
			<LineBusiness>DivisionName</LineBusiness>
        </ListingDetails>
		<RentalDetails>
			<Availability>'Contact For Details' or date here</Availability>
			<PetsAllowed>Yes</PetsAllowed>
		</RentalDetails>			
		<BasicDetails>
			<PropertyType>Townhouse</PropertyType>
			<PropertyTypeDescription>Description here</PropertyTypeDescription>
			<Title>Beautiful Home!</Title>
			<ShortDescription>Short description here. Short description here. Short description here.</ShortDescription>
            <Description>This is a longer description here. This is a longer description here. This is a longer description here. This is a longer description here. This is a longer description here. This is a longer description here. This is a longer description here. This is a longer description here.</Description>
            <Bedrooms>3</Bedrooms>
            <Bathrooms>2</Bathrooms>
            <LivingArea>2037</LivingArea>
			<LotSize>31000</LotSize>
            <YearBuilt>1939</YearBuilt>
			<MortgageeSale>Yes</MortgageeSale>
			<LivingRooms>5</LivingRooms>
        </BasicDetails>
		<SalesInfo>
			<SoldDate>6-15-2016</SoldDate>
			<MethodSale>something</MethodSale>
			<AucTenDateTime>6-15-2016 14:12:00</AucTenDateTime>
			<AucTenLocation>Pillsbury, MN</AucTenLocation>	
		</SalesInfo>
        <Pictures>
            <Picture>
            	<PictureUrl>http://picture.com</PictureUrl>
            </Picture>
        </Pictures>
        <Agent>
            <FirstName>Jennifer</FirstName>
            <LastName>Stansfield</LastName>
            <EmailAddress>jennifer.stansfield@somewebsite.com</EmailAddress>
			<MobilePhoneLineNumber>555.555.1212</MobilePhoneLineNumber>
			<LicenseNum>239493</LicenseNum>
			<BranchRefNo>12435</BranchRefNo>
		</Agent>
		<CoAgent>
			<FirstName>Bill</FirstName>
            <LastName>Jennings</LastName>
            <EmailAddress>bill.jennings@somewebsite.com</EmailAddress>
			<MobilePhoneLineNumber>555.555.1313</MobilePhoneLineNumber>
			<LicenseNum>239494</LicenseNum>
		</CoAgent>
		<SaleAgent>
			<FirstName>Joe</FirstName>
            <LastName>Blake</LastName>
            <EmailAddress>joe.blake@somewebsite.com</EmailAddress>
			<MobilePhoneLineNumber>555.555.1414</MobilePhoneLineNumber>
			<LicenseNum>239434</LicenseNum>
		</SaleAgent>
		<CoSaleAgent>
			<FirstName>Craig</FirstName>
            <LastName>Gano</LastName>
            <EmailAddress>craig.gano@somewebsite.com</EmailAddress>
			<MobilePhoneLineNumber>555.555.1111</MobilePhoneLineNumber>
			<LicenseNum>1352738</LicenseNum>
		</CoSaleAgent>
        <Office>
            <StreetAddress>1313 South Frisco</StreetAddress>
            <UnitNumber>24</UnitNumber>
            <City>Adrian</City>
            <State>MN</State>
            <Zip>75904</Zip>
            <OfficeName>Real Estate Company Branch Name</OfficeName>
        </Office>
		<OpenHouses>
			<OpenHouse>
				<Date>6-15-2016</Date>
				<StartTime>15:30</StartTime>
				<EndTime>17:30</EndTime>
			</OpenHouse>
		</OpenHouses> 
		<Fees>
			<Fee> 
				<FeeAmount>200</FeeAmount>
			</Fee>
		</Fees>
		<Schools>
			<District>Alpine</District>
			<Elementary>Legacy</Elementary>
			<Middle>West Mountain</Middle>
			<High>Pleasant Grove</High>
		</Schools>
		<Neighborhood>
			<Name>Hansen Ranch</Name>
		</Neighborhood>
        <RichDetails>
			<ArchitectureStyle>Modern</ArchitectureStyle>
			<Attic>Yes</Attic>
			<Basement>Yes</Basement>
			<CoolingSystem>Forced Air</CoolingSystem>
			<Fireplace>Wood Stove</Fireplace>
			<HeatingSystem>Gas</HeatingSystem>
			<HottubSpa>Yes</HottubSpa>
			<NumParkingSpaces>3</NumParkingSpaces>
			<OnsiteLaundry>In home</OnsiteLaundry>
			<ParkingType>Garage</ParkingType>
			<Pool>Yes</Pool>
			<RoofType>Metal</RoofType>
			<TennisCourt>Yes</TennisCourt>
			<FencedYard>Yes</FencedYard>
			<Furnished>Yes</Furnished>
        </RichDetails>
		<Misc>
			<Item>Item 1: Some customers use this to highlight the top selling features of the home.</Item>
			<Item>Item 2</Item>
			<Item>Item 3</Item>
			<Item>Item 4</Item>
			<Item>Item 5</Item>
		</Misc>			
    </Listing>
</Listings>

Adding images to your properties:

Use the <Pictures> <Picture> Nodes. Ex:

<Pictures>
        <Picture>
            <PictureUrl>https://images.unsplash.com/photo-1523217582562-09d0def993a6?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=1160&q=80</PictureUrl>
        </Picture>
        <Picture>
            <PictureUrl>https://images.unsplash.com/photo-1520608421741-68228b76b6df?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1yZWxhdGVkfDN8fHxlbnwwfHx8fA%3D%3D&auto=format&fit=crop&w=500&q=60</PictureUrl>
        </Picture>
        <Picture>
            <PictureUrl>https://images.unsplash.com/photo-1479839672679-a46483c0e7c8?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1yZWxhdGVkfDd8fHxlbnwwfHx8fA%3D%3D&auto=format&fit=crop&w=500&q=60</PictureUrl>
        </Picture>
</Pictures>

Learn more about auto-populating images to documents.

Adding license numbers to properties

If you have enabled data restrictions, you must add license numbers to your agents and to your properties. Ex:

  <Agent>
            <FirstName>Josh</FirstName>
            <LastName>Juneau</LastName>
            <EmailAddress>josh@example.com</EmailAddress>
            <MobilePhoneLineNumber>(555) 555-1419</MobilePhoneLineNumber>
            <LicenseNum>165152346,165152398, 165152374</LicenseNum>
            <BranchRefNo></BranchRefNo>
</Agent>

Supported data fields for property listings

If you are connecting your property listings, you can connect the listing data through your MLS, XML (such as Zillow), or through Google Sheets. Below is a list of supported fields that can be pulled into Marq depending on the data source method. Depending on how you connect your listings to Marq, some fields might not be supported. Please email support@marq.com for updates on new fields. listing.