Select Page
View all Web API examples ▸

MLS Property Info Network

MLS Provider: Bridge API

A1 | See all available Data Systems

To get the complete list of DataSystems provided by a server, append /DataSystem to the URI Stem of the server. Each Data System provided by the service will be listed as items and will contain a list all available Resources for that... https://api.bridgedataoutput.com/api/v2/OData/DataSystem Top ▴

A2 | Get metadata

Retrieve metadata for a specific service in OData EDMX/xml format. https://api.bridgedataoutput.com/api/v2/OData/mlspin/$metadata Top ▴

A3 | Get single Data System

Select a specific Data System and list its resources. The DataSystem endpoint will list all available Resources. https://api.bridgedataoutput.com/api/v2/OData/DataSystem('mlspin') Top ▴

B4 | Filter for specific Property

There are several ways to get a single property. By ID as in this example or including the unique key (i.e. Listing Key) in the Property attribute. i.e. Property(‘23442234’). Resultant fields are dictated by the $select... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=ListingKey eq 'f17529b9391e278a6c1f690db838f769'&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent Top ▴

B5 | Filter by resource key

You can search most resources by using that resource’s unique identifier. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties('f17529b9391e278a6c1f690db838f769') Top ▴

C10 | Filter on same field

Use parenthesis and logical ‘and’ or ‘or’ to group filter expressions. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=BedroomsTotal lt 5 or (BedroomsTotal eq 4 and IDXParticipationYN eq true)&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent Top ▴

C11 | Filter using not equal

not equal (ne) is used as to counter equal (eq) https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=BedroomsTotal ne 33&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent Top ▴

C6 | Filter on multiple field values

All names in the $filter option are case sensitive and must match the names of elements provided by the metadata resource. Values are also case sensitive. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=BedroomsTotal lt 5 and (City eq 'Boston') and (PropertyType has PropertyEnums.PropertyType'Residential')&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,BedroomsTotal Top ▴

C7 | Filter on Boolean field

Filter results by a boolean field (true or false). Note, do not treat the value true or false as a string. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=IDXParticipationYN eq true&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,IDXParticipationYN Top ▴

C8 | Filter on string fields

Filter a query by matching strings. Note that string comparisons are case sensitive. There are also string functions to aid with string filters but will vary depending on MLS Provider (i.e. toupper(StreetName) eq... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Member?$filter=(MemberFirstName eq 'James' or toupper(MemberFirstName) eq 'Adam')&$top=20 Top ▴

C9 | Filter using ‘not’ in an expression

A boolean ‘Not’ must enclose its operands in a parenthesis with not as an operator i.e. not(City eq ‘Elkwood’). https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=not(BedroomsTotal le 3) and (City eq 'Boston')&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,BedroomsTotal&$top=10 Top ▴

D12 | Sort Results

The $orderby system query option allows clients to request resources in either ascending order using asc or descending order using desc. If asc or desc not specified, then the resources will be ordered in ascending (asc) order. A compliant client SHOULD use the... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=ListPrice lt 1000000 and (PropertyType has PropertyEnums.PropertyType'Residential')&$orderby=ListPrice desc&$top=20&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,Longitude,Latitude,City,ListPrice,Appliances,ModificationTimestamp Top ▴

D13 | Return only limited number of records

Get first 10 results from query/filter. All names in the $select option are case-sensitive to match the names of elements provided by the resource. The implementation of $top and $orderby is defined by the server and may restrict what values may be used in either... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Member?$top=10&$select=MemberLastName,MemberFirstName&$filter=toupper(MemberFirstName) eq 'JOHN' Top ▴

D14 | Skip n records and get next m records

Skip by the first 10 results and return the 2nd 10 results from a filter. If more records exist in the query than returned then using the @odata.nextLink value from the result is another way to retrieve remaining... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Member?$skip=10&$top=10&$orderby=MemberLastName&$select=MemberLastName,MemberFirstName Top ▴

D15 | Expand Resources in results

The $expand system query option specifies the related resources to be included in line with retrieved resources. Look for the NavigationProperty in the metadata to determine if a resource is linked for expansion. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=(City eq 'Boston') and (PropertyType has PropertyEnums.PropertyType'Residential') and PhotosCount gt 1&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,PhotosCount&$expand=ListAgent Top ▴

D16 | Ouput a selected set of fields

The resultant output (usually JSON) can be dictated by using the OData ‘select’ statement. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=BedroomsTotal eq 3&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent Top ▴

E17 | Filter on single value enumeration

A Single Valued Lookup is a field that can have one and only one selection from a list of values. The Web API Implements Single Valued Lookup fields using the OData data type of Edm.EnumType with an underlying type of... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=(PropertyType has PropertyEnums.PropertyType'Residential') and PropertyType has PropertyEnums.PropertyType'Residential'&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,PropertyType Top ▴

E18 | Filter on multi-valued enumeration

A Multi-Valued Lookup is a field that can have one or more items selected from a list of values. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=(PropertyType has PropertyEnums.PropertyType'Residential') and (Appliances has PropertyEnums.Appliances'Dryer') or (Appliances has PropertyEnums.Appliances'Washer')&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,Appliances Top ▴

F19 | Filter on a Date

Filtering on a date requires date fields to be defined as dates (Type=”Edm.Date”) in the metadata https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=ListingContractDate lt 2016-12-31 and (PropertyType has PropertyEnums.PropertyType'Residential')&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,ListingContractDate Top ▴

F20 | Filter on time

Filtering on time can use of the hour, minute, second and fractional seconds functions. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=year(ModificationTimestamp) eq 2018 and month(ModificationTimestamp) gt 5 and day(ModificationTimestamp) lt 31 and hour(ModificationTimestamp) gt 1 and minute(ModificationTimestamp) gt 3 and (PropertyType has PropertyEnums.PropertyType'Residential')&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,ModificationTimestamp Top ▴

F21 | Filter on a fractional second

filtering on fractions of a second requires the use of the function fractionalseconds() https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=ListingContractDate lt 2016-12-31 and fractionalseconds(ModificationTimestamp) lt 30 and (PropertyType has PropertyEnums.PropertyType'Residential')&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,ListingContractDate,ModificationTimestamp

HAR: Cannot apply any filters on ModificationTimestamp (incompatible types)

Top ▴

F22 | Filter on a date value of now

The function now() will return the now time in UTC https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=ModificationTimestamp le now()&$top=10

HAR: Cannot apply any filters on ModificationTimestamp (incompatible types)

Top ▴

G23 | Filter on a string that starts with

Filter on a string field value that starts with a certain value. This is case sensitive https://api.bridgedataoutput.com/api/v2/OData/mlspin/Member?$filter=startswith(MemberFirstName, 'Joh')&$select=MemberFirstName,MemberLastName,MemberStatus,ModificationTimestamp&$top=20

FBS does not recognize startswith(). Getting ‘Resource not found.’ error

Top ▴

G24 | Filter on a string that ends with

Filter on a string field value that ends with a certain value. This is case sensitive https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=endswith(StreetName, 'R')&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,StreetName&$top=10 Top ▴

G25 | Filter a string that contains

Filter on a string field value that contains a certain value. This is case sensitive https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=contains(toupper(StreetName),'MAIN')&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent Top ▴

G26 | Filter by comparing upper case

Convert a string to upper case (toupper). Lower case would use the function tolower(). https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=toupper(StreetName) eq 'FRONT STREET'&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent,StreetName Top ▴

H27 | Geospatial Filter within a radius

A geographic search from a point in the Data System. Note that the structure of a geospatial search can vary per MLS.Search. Pay attention to MLS Service metadata name for Type=”Edm.GeographyPoint”. https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=geo.distance(Coordinates, POINT(-71.106631 42.388223)) le 3&$top=10

MLSPIN: Geo searches are not working

Top ▴

H28 | Geospatial Filter within a polygon

Need a minimum of four points to search by a polygon. The first and last points must be the same and because you’re able to put ‘holes’ into your polygon, you’d need to wrap the coords in another set of parenthesis. Note that the structure of a... https://api.bridgedataoutput.com/api/v2/OData/mlspin/Properties?$filter=(PropertyType has PropertyEnums.PropertyType'Residential') and geo.intersects(Coordinates,POLYGON((-71.106631 42.388223,-71.132453 42.388694,-71.140783 42.412775,-71.106858 42.412863)))&$top=10&$select=ListingKey,ListingContractDate,BedroomsTotal,StreetName,OnMarketDate,PropertyType,ModificationTimestamp,ListAgent

MLSPIN: Geosearches are not working

Top ▴
Subscribe To Our Blog!

Subscribe To Our Blog!

Join our mailing list to receive the latest news and updates from our team.

You have Successfully Subscribed!