IDX Links

The IDX Links API is used to retrieve the list of IDX links created by flexmls Web IDX subscribers.
  1. Supported Roles
  2. Available Services
    1. All IDX Links
    2. Individual IDX Link
    3. Default IDX Link
  3. Response Description
  4. Expansions
  5. API Explorer

Supported Roles

Role Reads? Writes?
IDX Yes No
VOW Yes No
Private Yes No
More information about roles may be found here.

Available Services

All IDX Links

URI: /<API Version>/idxlinks

HTTP Method Description Notes
GET Returns a list of all IDX links for the current user
POST,PUT,DELETE Returns HTTP 405 (Method Not Allowed) Not implemented

GET Request

Parameters:
  • None

GET Response

Example:
{
    "D": {
        "Success": true,
        "Results": [
            {
                "ResourceUri": "/idxlinks/20101115061222486591000000",
                "Id": "20101115061222486591000000",
                "Name": "Residential Search",
                "Uri": "http://link.flexmls.com/riptgq7ohvr,12",
                "LinkId": "riptgq7ohvr",
                "LinkType": "QuickSearch",
                "QuickSearchId": "20101219154253948578000000"
            },
            {
                "ResourceUri": "/idxlinks/20101116011322386631000000",
                "Id": "20101116011322386631000000",
                "Name": "Commercial Search",
                "Uri": "http://link.flexmls.com/Xiptgq7ohvr,12",
                "LinkId": "Xiptgq7ohvr",
                "LinkType": "QuickSearch",
                "QuickSearchId": "20111219354254944572000000"
            }
        ]
    }
}

Individual IDX Link

URI: /<API Version>/idxlinks/<Id>

HTTP Method Description Notes
GET Returns info about the specified IDX link
POST,PUT,DELETE Returns HTTP 405 (Method Not Allowed) Not implemented

GET Request

Parameters:
  • None

GET Response

Example:
{
    "D": {
        "Success": true,
        "Results": [
            {
                "ResourceUri": "/idxlinks/20101116011322386631000000",
                "Id": "20101116011322386631000000",
                "Name": "Commercial For Sale",
                "Uri": "http://link.flexmls.com/Xiptgq7ohvr,12",
                "LinkId": "Xiptgq7ohvr",
                "LinkType": "SavedSearch",
                "SearchId": "20091219144256948576000000"
            }
        ]
    }
}

Default IDX Link

URI: /<API Version>/idxlinks/default

Many users have an IDX link they prefer to be used as their IDX link.

HTTP Method Description Notes
GET Returns the user's default IDX link
POST Returns HTTP 405 (Method Not Allowed) Not implemented
PUT Returns HTTP 405 (Method Not Allowed) Not implemented
DELETE Returns HTTP 405 (Method Not Allowed) Not implemented

GET Request

Parameters:
  • None

GET Response

See the GET request section for IDX links service.

IDX Links Description

Attribute Data Type Description
ResourceUri Character The URI to the IDX link resource
Id Character The unique id of the IDX link
Name Character The name of the IDX link
Uri Character The URI of the IDX link itself. This link may be opened with a web browser
LinkId Character The alternative unique Id as used in the URI
LinkType Character Valid values include: QuickSearch, SavedSearch, MyListings, and Roster. Each link type represents what content will appear when the link is loaded in the browser
QuickSearchId Character Only provided when LinkType=QuickSearch . This is the ID of the Quick Search that's used in the IDX link
SearchId Character Only provided when LinkType=SavedSearch . This is the ID of the Saved Search that's used in the IDX link
Settings Expansion The attributes below reside under the Settings expansion
ResultsRequireRegistration Boolean If true, the end user should be presented with a registration prompt before viewing listing search results
DetailRequiresRegistration Boolean If true, the end user should be presented with a registration prompt before viewing listing detail reports
RegistrationAfterMinutes Integer The end user should be prompted to register for a VOW account after the user has visited the IDX link for this many minutes
RegistrationAfterSearches Integer The end user should be prompted to register for a VOW account after this many listing searches have been run
RegistrationAfterListingViews Integer The end user should be prompted to register for a VOW account after this many listings have been viewed
RegistrationBypass Boolean Users are allowed to bypass the registration prompt

Expansions

Expansion Roles Single Record Only? Selection Support? Description
Settings All Yes No A hash detailing user defined settings for the IDX link.

API Explorer

Interact with this service using the API Explorer.