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 Notes
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 Conditional Notes
GET Returns a list of all IDX links for the current user. No
POST Returns HTTP 405 (Method Not Allowed) No Not implemented
PUT Returns HTTP 405 (Method Not Allowed) No Not implemented
DELETE Returns HTTP 405 (Method Not Allowed) No Not implemented

GET Request

Parameters:
Parameter Required Notes
Standard search and paging syntax No

GET Response

{
    "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",
                "UseAsNewSearch": false
            },
            {
                "ResourceUri": "/idxlinks/20101116011322386631000000",
                "Id": "20101116011322386631000000",
                "Name": "Commercial Search",
                "Uri": "http://link.flexmls.com/Xiptgq7ohvr,12",
                "LinkId": "Xiptgq7ohvr",
                "LinkType": "QuickSearch",
                "QuickSearchId": "20111219354254944572000000",
                "UseAsNewSearch": false
            }
        ]
    }
}

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",
                "UseAsNewSearch": true
            }
        ]
    }
}

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 Conditional Notes
GET Returns the user's default IDX link No
POST Returns HTTP 405 (Method Not Allowed) No Not implemented
PUT Returns HTTP 405 (Method Not Allowed) No Not implemented
DELETE Returns HTTP 405 (Method Not Allowed) No Not implemented

GET Request

Parameters:
  • None

GET Response

See the GET request section for IDX links service.

IDX Links Description

Attribute Data Type Searchable Description
ResourceUri Character No The URI to the IDX link resource
Id Character No The unique id of the IDX link
Name Character No The name of the IDX link
Uri Character No The URI of the IDX link itself. This link may be opened with a web browser
LinkId Character No The alternative unique Id as used in the URI
LinkType Character No 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 No Only provided when LinkType=QuickSearch . This is the ID of the Quick Search that's used in the IDX link
SearchId Character No Only provided when LinkType=SavedSearch . This is the ID of the Saved Search that's used in the IDX link
UseAsNewSearch Boolean Yes If true, the link has been specified as selectable by consumers to use the the basis for starting a new search. For VOW roles, only links with this attribute set to true are returned in this service.
Settings Expansion The attributes below reside under the Settings expansion
ResultsRequireRegistration Boolean No If true, the end user should be presented with a registration prompt before viewing listing search results
DetailRequiresRegistration Boolean No If true, the end user should be presented with a registration prompt before viewing listing detail reports
RegistrationAfterMinutes Integer No 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 No The end user should be prompted to register for a VOW account after this many listing searches have been run
RegistrationAfterListingViews Integer No The end user should be prompted to register for a VOW account after this many listings have been viewed
RegistrationBypass Boolean No 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.