GeoDirectory MLS Import

Description

GeoDirectory MLS Import connects your site to your MLS through the RESO Web API and imports listings into GeoDirectory.

Enter the credentials your MLS or IDX vendor issued you, pick a dataset, choose which listings you want, and GeoDirectory MLS Import keeps them in sync on a schedule you control.

What it does

• Imports from any RESO Web API (OData) compliant feed.
• Maps RESO fields onto GeoDirectory custom fields, overridable per import.
• Downloads listing photos to your media library, or hotlinks the MLS image URLs.
• Runs in the background, so large datasets import without timing out. Pause, resume or stop a run at any time, and resume an interrupted one where it left off.
• Previews a run before you start it, showing what would be imported, updated or skipped without changing anything.
• Re-runs hourly, daily, weekly or monthly, updating only listings that changed.
• Optionally trashes listings that have left the feed.
• Logs every listing processed, skipped or failed.

Filtering

Narrow an import by:

• Listing status, property type and subtype
• State, city, street address and postal code
• Listing agent and office, including exclusions
• Price range and price display rules
• A maximum number of listings, or one listing by ListingId / ListingKey
• Any custom OData filter expression your feed supports

Filters are sent to the provider as part of the query, so narrowing happens at the feed.

Your import

The plugin manages one import: a saved configuration of dataset, filters, field mapping and schedule, with scheduling, images and every filter above included. Change any of it whenever you like, or point it at a different dataset.

Supported MLS platforms

Presets ship for Trestle, Bridge Data Output, Spark Platform and Navica. Paragon, Rapattoni and other RESO Web API providers need their endpoints added with the geomls_service_config filter. If your MLS is not listed, contact AyeCode support.

Requirements

• GeoDirectory 2.3 or higher
• RESO Web API credentials from your MLS or IDX vendor

GeoDirectory MLS Import does not include, resell or provide access to any MLS data. You must have your own agreement with, and credentials from, your MLS or IDX vendor.

External services

This plugin contacts a third-party MLS or IDX provider to retrieve the listings you ask it to import. Nothing is sent anywhere until you enter API credentials and run an import.

Which service is contacted

The RESO Web API endpoint belonging to the MLS or IDX vendor you configure under GeoDirectory > Settings > MLS Import. The plugin contacts no endpoint of its own. Presets are provided for the following, and a developer can add other RESO Web API endpoints with the geomls_service_config filter:

• Trestle by Cotality – api-trestle.corelogic.com (terms, privacy policy)
• Bridge Data Output – api.bridgedataoutput.com (terms, privacy policy)
• Spark Platform – sparkapi.com (terms, privacy policy)
• Navica – navapi.navicamls.net (privacy policy, published by its operator Systems Engineering, Inc.). Navica publishes no public terms-of-use page for the API; access is granted by your MLS and governed by the data agreement they issue you.
• Paragon – endpoints supplied by your MLS and added with the filter above
• Rapattoni – endpoints supplied by your MLS and added with the filter above

When requests are made

• When you save API credentials, to verify they work.
• When you load or refresh the list of datasets available to your account.
• When you search for an agent, office or other filter value while building an import.
• When you preview an import.
• When an import runs, manually or on its schedule.
• When listing images are downloaded, if you enabled that. Images come from the image host named in the feed, which your MLS chooses.

What is sent

• Your API credentials (client ID, client secret, server token, or username and password, depending on the provider), to authenticate.
• The OData query built from your filters, containing only the field names and values you selected.

No WordPress user data, site content or information about your visitors is transmitted.

What is received

Property listing records and media URLs from the dataset you selected, stored as GeoDirectory listings on your site.

Your use of these services is governed by your own agreement with your MLS or IDX vendor, in addition to the terms and privacy policies above.