Secure Post Url:
https://www.freerentalsite.com/post/
( Warning: This will slow the performance of your post, but can be used to secure the transmission )
Your gateway password. Can be found by logging into your account,
clicking on the "My Account".
<testmode>
X
boolean
Process this transaction in test mode? 0 = Not a Test Transaction (will process your ad) 1 = Test Mode (will validate xml / data only)
<ad>
<metainfo>
<adID>
C
integer
The unique adID that we generate when the ad is created. If the adID is not supplied we will create a brand new ad.
If you do supply an adID we will update that ads information.
<sourceID>
string(50)
This is Your Unique ID. This will allow you to update your ads without having to
store our ID's on your system. Example: The first time you feed an ad with a source id of
"A12345" it will create a new ad. The next time your feed an ad with the same source id "A12345"
it will update your original ad on our system with new information. It will not create a new ad.
<adStatusID>
integer
This will allow you to change the status of the ad on our system. 1 = Activate(available for the public to see) 2 = De-Activate(available for property manager to see but not the public) 3 = Delete(ad gets archived so no one can see the ad, however it isn't removed from the system)
<segmentID>
integer
Allows you to override the default API you are posting to. If posting to FreeRentalSite.com
and you do not supply a segmentID it will default to 1. If posting to www.FreeRentalSite.com and you
supply a segmentID of 2 then your ad will be posted to www.FreeCommercialSite.com. This will allow you
to post Rental, Commercial, Real Estate, and Vacation Rental Ads in one feed.
***Note by overriding the default segmentID you will be validated against
that site's API. 1 = www.FreeRentalSite.com 2 = www.FreeCommercialSite.com 3 = www.FreeRealEstateSite.com 4 = www.FreeVacationRentalSite.com
</metainfo>
<address>
<countryCode>
X
string(3)
The country code of the property.
E.g. United States = US. Please choose from a list below: AU = Australia BS = Bahamas BD = Bangladesh BM = Bermuda BR = Brazil BG = Bulgaria CA = Canada CN = China CO = Colombia CR = Costa Rica CD = Democratic Republic of the Congo DK = Denmark EG = Egypt ET = Ethiopia FI = Finland FR = France DE = Germany GR = Greece IN = India ID = Indonesia IR = Iran IE = Ireland IT = Italy JP = Japan KE = Kenya LT = Lithuania MT = Malta MX = Mexico ME = Montenegro MM = Myanmar NL = Netherlands NZ = New Zealand NG = Nigeria NO = Norway PK = Pakistan PA = Panamá PH = Philippines PL = Polska PR = Puerto Rico QA = Qatar RU = Russia KN = Saint Kitts and Nevis SG = Singapore ZA = South Africa KR = South Korea ES = Spain SE = Sweden CH = Switzerland TW = Taiwan TZ = Tanzania TH = Thailand TR = Turkey UA = Ukraine AE = United Arab Emirates GB = United Kingdom US = United States VN = Vietnam
<stateName>
X
string(50)
The name of the State / Region / Province / Voivodship that the property is located in. E.g. "New York" is a State located in the United States of America.
The <stateName> must be spelled exactly as it is found in our system. Select from the list below:Select Your Country:
<cityName>
X
string(50)
The name of the City / Town / Village that the property is located in. E.g. "Toronto" is a city located in Ontario, Canada.
<address>
string(200)
The primary address of the property. E.g. "123 Main Street"
<address2>
string(200)
The secondary address of the property. E.g. "Suite 202"
<address3>
string(200)
The tertiary address of the property. E.g. "Office space 5"
<postalCode>
string(40)
The postal code of the property. E.g. Poland: "32-015", Canada: "M4B 1C4", United States: "80918"
</address>
<adinfo>
<adTitle>
X
string(200)
The title of the Ad.
<adDescription>
X
string(4000)
The detailed description of the property / unit.
<moveInSpecial>
string(500)
The description of any current move-in specials offered for this property / unit.
<websiteUrl>
string(250)
This is a permanent URL pointing to a webpage containing information regarding this property or your company. ***Only available for upgraded ads
<applicationUrl>
string(250)
This is a URL pointing to an online rental application.
<virtualTourUrl>
string(250)
This is a URL pointing to a webpage containing a virtual tour of the property / unit.
</adinfo>
<imginfo>
<deleteAllImages>
boolean
Allows you to delete all images attached to this ad. Will only be used when updating an existing ad. 0 = Don't Delete / Ignore Parameter
1 = Delete All Images
<urlString>
string(4000)
A comma seperated list of URL's for each Image to be attached to this Ad.
These images will be downloaded to our server, resized / optimized for performance,
and watermarked for security. We will also create a thumbnail to ensure our search results
load quickly for the end user. In the example below you will see we have three images
(House, Kitchen, Living Room):
http://www.freerentalsite.com/images/samples/house.jpg,
http://www.freerentalsite.com/images/samples/kitchen.jpg,
http://www.freerentalsite.com/images/samples/livingRoom.jpg,
<captionString>
string(4000)
A comma seperated list of Captions for the Images being attached to this ad. Must have one comma / item
per image even if the image doesn't have a caption. In the example below we have added a caption to our
1st and 3rd image, but not the 2nd:
View from the road, ,Living Room,
</imginfo>
<contactinfo>
<contactName>
C
string(200)
The name of the person that will be listed as the contact on the ad.
<contactCompany>
C
string(200)
The name of the company that will be listed as the contact on the ad.
<contactEmail>
X
string(150)
Email address of the person / entity to contact. This will be used to send any
correspondences from the contact button / lead form on the ad.
<licenseNbr>
string(50)
This is the licence number of the company / entity that is posting the ad.
<contactPhone1>
string(40)
Primary Contact Phone # displayed on the Ad.
<contactExt1>
string(16)
Primary Contact Phone's Extension
<contactName2>
string(200)
The name of the person that will be listed as the secondary contact on the ad.
<contactEmail2>
string(150)
Email address of the secondary person to contact. This will be used to send any
correspondences from the contact button / lead form on the ad.
<contactPhone2>
string(40)
Secondary Contact Phone # displayed on the Ad.
<contactExt2>
string(16)
Secondary Contact Phone's Extension
</contactinfo>
<propertyinfo>
<propertyTypeID>
X
integer
The type of property being listed. Must select one of the options below: 1 = Single Family House 2 = Townhouse 3 = Condo 4 = Apartment 5 = Loft 6 = Multiplex 30 = Mobile Home 31 = Other 32 = Duplex 39 = Corporate Housing
<multiUnit>
boolean
Ad is a Multi Unit Listing. Allows you to supply a range of values for Rent / Deposit / Area / Beds / Baths.
Note: If not supplied this will default to 0 for single unit listing. 0 = NOT a Multi Unit Listing. Single Unit Listing Only
1 = Multi Unit Listing
<currencyTypeID>
X
integer
The currency type for all financial fields of the ad. E.g.: Rent Amount / Purchase Price / Deposit / Taxes.
Must select one of the options below: 1 = United States Dollar (USD) 2 = Canadian Dollar (CAD) 3 = Australian Dollar (AUD) 4 = New Zealand Dollar (NZD) 5 = Hong Kong Dollar (HKD) 6 = Euro (EUR) 7 = Japanese Yen (JPY) 8 = Pound Sterling (GBP) 9 = Swiss Franc (CHF) 10 = Swedish Krona (SEK) 11 = Norwegian Krone (NOK) 12 = Mexican Peso (MXN) 13 = Singapore Dollar (SGD) 14 = South Korean Won (KRW) 15 = Indian Rupee (INR) 16 = Chinese Yuan (CNY) 17 = Polish zloty (PLN) 18 = Israeli shekel (ILS) 19 = Singapore Dollar (SGD) 20 = Czech koruna (CZK) 21 = Danish krone (DKK) 22 = New Taiwan Dollar (TWD) 23 = Brazilian real (BRL) 24 = South African rand (ZAR) 25 = Indonesian Rupiah (IDR) 26 = Bangladeshi taka (BDT) 27 = Pakistani rupee (PKR) 28 = Nigerian naira (NGN) 29 = Russia Rubles (RUB) 30 = Panamanian Balboa (PAB) 31 = Iran Rials (IRR) 32 = Turkish Lira (TRY) 33 = Congolese Franc (CDF) 34 = Thailand Baht (THB) 35 = Myanma kyat (MMK) 36 = Philippine peso (PHP) 37 = Colombian peso (COP) 38 = Ukrainian hryvnia (UAH) 39 = Tanzanian shilling (TZS) 40 = Bulgarian lev (BGN) 41 = Singapore Dollar (SGD) 42 = Lithuanian litas (LTL) 43 = Bahamian dollar (BSD) 44 = East Caribbean Dollar (XCD) 45 = Kenyan shilling (KES) 46 = Costa Rican Colón (CRC)
<amount>
X
decimal(11,2)
Rent Amount of the property being listed.
<amountMax>
decimal(11,2)
Maximum Rent Amount of the property being listed.
For Multi Unit Listing Only
<rentFrequencyID>
C
integer
The frequency at which the rent is collected. Must select one of the options below: 1 = Amt / Night 2 = Amt / Week 4 = Amt / Month 6 = Amt / Quarter 8 = Amt / Year
<deposit>
decimal(11,2)
The amount of the deposit according to the terms of the lease, or sale.
<depositMax>
decimal(11,2)
Maximum Deposit Amount for the property being listed. For Multi Unit Listing Only
<depositText>
string(100)
A description of the deposit. This can be used instead of deposit if you would prefer to use text instead of a monetary value.
<applicationFee>
decimal(11,2)
The fee amount that is required to apply for the property being listed.
<beds>
C
integer
The number of bedrooms the property has.
<bedsMax>
integer
Maximum # of bedrooms offered in a unit for the property being listed. For Multi Unit Listing Only
Maximum # of bathrooms offered in a unit for the property being listed. For Multi Unit Listing Only
| 1 | 1.5 | 2 | 2.5 | 3 | 3.5 | 4 | 4.5 | 5 | 5.5 | 6 | 6.5 | 7 | 7.5 | 8 | 8.5 | 9 | 9.5 | 10 |
<area>
C
integer
The area or size of the property. Eg. "2000" for 2000 sq. meters.
<areaMax>
integer
The max area or size of the property. Eg. "2000" for 2000 sq. meters.. For Multi Unit Listing Only
<uomID>
C
integer
The unit of measurement for area / size of the property. Must select one of the options below: 1 = SqFt 2 = m²
<floors>
integer
The number of floors the property has.
<yearBuilt>
integer
The year that the property was built.
<locatedNear>
string(2000)
The description of the surrounding area, including restaurants, stores, or other amendities near and/or accessible to this property.
<schools>
string(2000)
The description of the school system for this property. Either School district name, or school system options available. May also list individual schools.
<securityDescription>
string(2000)
The description of any security systems that are available or provided on the property.
</propertyinfo>
<leaseinfo>
<availabilityDate>
date (yyyymmdd)
The date that the property is available to move into.
<sectionEight>
boolean
Is section 8 housing assistance accepted?
0 = No Accepted
1 = Accepted
[empty] = Ignore / Not Applicable
<sectionEightArea>
string(100)
The Section 8 Governing Area
<leaseDescription>
string(2000)
The decription of the lease terms available.
</leaseinfo>
<restrictions>
<dog>
boolean
0 = no dogs allowed
1 = dogs allowed
<cat>
boolean
0 = no cats allowed
1 = cats allowed
<petDescription>
string(400)
Additional description of the pet policy for the property.
<smoking>
boolean
0 = no smoking allowed (outside only)
1 = smoking allowed inside the property
<housingAssistance>
boolean
0 = housing assistance not accepted
1 = housing assistance accepted / available
</restrictions>
<utilities>
<gas>
boolean
0 = tenant pays 1 = included in rent
<electric>
boolean
0 = tenant pays 1 = included in rent
<water>
boolean
0 = tenant pays 1 = included in rent
<sewage>
boolean
0 = tenant pays 1 = included in rent
<garbage>
boolean
0 = tenant pays 1 = included in rent
<lawn>
boolean
0 = tenant pays 1 = included in rent
<cable>
boolean
0 = tenant pays 1 = included in rent
<internet>
boolean
0 = tenant pays 1 = included in rent
<phone>
boolean
0 = tenant pays 1 = included in rent
<heat>
boolean
0 = tenant pays 1 = included in rent
<snow>
boolean
0 = tenant pays 1 = included in rent
<noUtilities>
boolean
0 = not set 1 = NO UTILITIES are included in rent
<heatType>
string(50)
Type of heating (gas, electric)
</utilities>
<parking>
<spaceCount>
integer
# of Parking Spaces for this Property (whole numbers only ie: 1, 2, 3)
<coveredCount>
integer
# of Covered Parking Spaces for this Property (whole numbers only ie: 1, 2, 3)
<garageCarCount>
integer
# of Garage Parking Spaces for this Property (whole numbers only ie: 1, 2, 3)
<parkingCost>
string(200)
The description of any charges associated with parking.
</parking>
<features>
<featureString>
string(4000)
A comma seperated list of the features applicable to the property being listed (E.g.: 1,4,6,11,23,32,). Must select from the list below: 1 = Breakfast Nook 2 = Dishwasher 3 = Disposal 4 = Island 5 = Microwave 6 = Pantry 7 = Refrigerator 8 = Stove 270 = Coffee Pot 271 = Electric Tea Kettle 272 = Lazy Susan 284 = Oven 423 = Granite Countertops 430 = Range 431 = Ice maker 434 = Eat in kitchen 482 = Trash Compactor 451 = Oven & Gas Stovetop 529 = Double Oven 576 = Pot Filler 427 = Vinyl 428 = Concrete 424 = Laminate Flooring 425 = Parquet Flooring 279 = Marble Flooring 9 = Ceramic Tile 10 = Hardwood Flooring 11 = Carpet 12 = Linoleum 13 = Crawlspace 14 = Den 15 = Dining Room 16 = Finished Basement 17 = Living Room 18 = Recreation Room 19 = Study 20 = Unfinished Basement 21 = Utility Room 22 = Wet Bar 264 = Kitchenette 167 = Family room 168 = Foyer 412 = Movie Room 416 = Reading Room 417 = Weight Room 418 = Cardio Room 419 = Aerobics Studio 293 = Guest Suite 294 = Office 406 = Party Room 407 = Exercise Room 449 = Loft 442 = First Floor Bedroom 443 = First Floor Master 606 = Primary Bedroom 607 = Primary Bathroom 530 = Great Room 531 = Laundry Room 532 = Master Bedroom 452 = Living/Dining Room Combo 525 = Sauna/Spa Room 526 = Workshop 527 = Detached Workshop 528 = Clubhouse 556 = Hearth Room 557 = Screened Porch 558 = Balcony 559 = Bonus Room 560 = 3 Season Room 454 = Stackable Washer & Dryer 539 = Drapes 540 = Shutters 541 = Cape Code Style 542 = Colonial Style 543 = Contemporary Style 544 = Traditional Style 545 = Tudor Style 546 = 1.5 Story Layout 547 = 2 Story Layout 548 = Raised Ranch Layout 549 = Ranch Layout 550 = Split Layout 551 = Bi-Level Layout 552 = Open Design 553 = Recently Remodeled 554 = Alarm System Monitored (Tenant Paid) 555 = Alarm System Not Monitored 535 = Solar Panels 574 = Heating 603 = Storage Area 604 = Sprinkler System 590 = Community Pool 591 = Clubhouse 592 = Playground 593 = Tennis Courts 594 = Fitness Center 444 = Sun Room 445 = Lake View 446 = Washer 447 = 10' Ceilings 448 = 9' Ceilings 435 = Garden Tub 436 = Stall Shower 437 = Gas Fireplace 438 = Screened Porch 439 = Cul de Sac 440 = Dual Vanity 441 = Trey Ceiling 456 = Garage 409 = Whirlpool 278 = Window Security Blinds 261 = High Speed internet 262 = Cable 263 = Electric Tea Pot 420 = Rooftop Terrace 414 = Golf Simulator 415 = Billiards Room 172 = Window coverings 173 = Telephone 174 = Intercom 157 = Floor to Ceiling Windows 158 = Television 159 = Sundeck 160 = Secure, controlled access 161 = Concierge/Doorman 162 = Ironing Board 265 = Furniture 266 = Coffee Pot 267 = Iron 268 = Infloor Heating 269 = Lot 280 = Dryer 281 = Washing Machine 282 = Maid Service 23 = Air Conditioning 24 = Attic 25 = Blinds 26 = Book Shelf 27 = Cable Ready 28 = Ceiling Fan 29 = Central Vacuum 30 = Fireplace 31 = Furnishings 32 = Handicap Access 33 = Heat 34 = Internet Ready 35 = Intrusion Alarm 36 = Jetted Tub 37 = Scenic View 38 = Skylights 39 = Vaulted Ceilings 40 = Walk In Closet(s) 41 = Washer / Dryer Hookups 42 = Climate Control 43 = Waterfront Property 44 = Balcony 45 = Deck 46 = Fence 47 = Hot Tub 48 = Patio 49 = Swimming Pool 50 = Porch 51 = Sprinkler 52 = Storage 163 = Garden 164 = Back yard 165 = Front yard 166 = Plot 260 = Courtyard 413 = Raquet Ball 287 = Barbeque 292 = Pond 408 = Sun Deck 450 = Pool Care 411 = Tennis Courts 536 = Solar Panels 566 = Barn 567 = Shed 568 = Lawn Cutting Provided 569 = Lawn Chemical Treatment Provided 570 = Lawn All Maintenance Provided 571 = Snow Removal Provided 453 = Patio-Screened 455 = On site management 429 = Basketball Courts 457 = Transportation 410 = Tennis Courts 295 = Steam Room 288 = Conference Room 289 = Library 290 = Computer room 291 = Movie Theatre 285 = Party Room 286 = Spa 426 = Outdoor Parking 432 = Game room 433 = Fitness center 169 = Coin Operated Laundry 170 = On site maintenance 171 = Media Room 283 = Billards / Pool Table 273 = Sauna 274 = Social Room 275 = Indoor Pool 276 = Indoor Parking 277 = Heated Parking 53 = Access Gate 54 = Business Center 55 = Club House 56 = Elevator 57 = Golf 58 = Gym / Excercise room 59 = Handicap Access 60 = Jacuzzi 61 = Laundry 62 = Playground 63 = Pool 64 = Racquet Ball 65 = Storage 66 = Tennis 67 = Volleyball 458 = Washer 459 = Electric Dryer 460 = HE Detergent 461 = Stacked Washer/Dryer 462 = W/D Hookups Only 463 = Community Laundry 464 = Coin-op Laundry 575 = Laundry Room Upstairs 533 = Gas Dryer 465 = Formal Dining Room 466 = Dining in Living/Great Room 467 = Dining in Family Room 468 = Eat in Kitchen 469 = Breakfast Room 470 = One Fireplace 471 = Two Fireplace 472 = Three or More Fireplaces 473 = Gas Fireplace 474 = Wood Fireplace 475 = Fireplace in Living Room 476 = Fireplace in Family Room 477 = Fireplace in Master Bedroom 478 = Two-Way Fireplace 479 = Wood Stove 480 = Pellet Stove 481 = No Fireplace 534 = Decorative Only 572 = Fireplace Electric 573 = Fireplace Not Usable 483 = No Pets 484 = Possible With Approval 485 = Cats 486 = Dogs Under 20lbs 487 = Dogs Over 20lbs 488 = Solar Hot Water 489 = Ceiling Fans 490 = Attic Fans 491 = Hot Tub 492 = Jetted Tub 493 = Sauna 494 = 55+ One Person 495 = No Smoking 496 = No Water-Filled Furniture 497 = 1 Car Garage 498 = 2 Car Garage 499 = 3 Car Garage 500 = 4+ Car Garage 501 = 1 Carport 502 = 2+ Carport 503 = Parking Slab 504 = Assigned Parking 505 = Unassigned Parking 506 = Covered Parking 507 = Street Parking 508 = RV Parking 509 = Electric Door Opener 510 = Separate Vehicle Storage Area 511 = Driveway Parking 512 = Tandem Parking 513 = No Parking 605 = Garage Parking 561 = 1 Parking Spot 562 = 2 Parking Spots 563 = 3+ Parking Spots 564 = Detached Garage 565 = Attached Garage 514 = Air Conditioning 515 = Window/wall Unit 516 = Central Air 517 = No Cooling 518 = City Water 519 = Private Water Company 520 = Private Well 521 = Water Softener 595 = Gas Water Heater 596 = Electric Water Heater 597 = Tankless Water Heater 522 = Public Sewer 523 = Private Sewer 524 = Septic Tank 598 = Gas Heating 599 = Electric Heating 600 = Oil Heating 601 = Propane Heating 602 = Other Heating
</features>
</ad>
</post>
RESPONSE XML
Req'd
DataType
Description
<response>
<errorCode>
n/a
integer
Feed Level Error Code 0 = No Feed Level Errors
<errorDescription>
n/a
string(4000)
A description of a feed level error. (ie: invalid xml)
<stats>
n/a
string(1000)
Statistics for the feed. Ie: # of ads processed.
<ad>
<adID>
n/a
integer
An output of our ad id that was generated. Only supplied if no errors encountered and not in test mode.
<errorCode>
n/a
integer
The Error Code for this specific ad. 0 = No Errors Encountered