Repliers' real estate APIs offer a standardized data dictionary across multiple MLSs, making it easier to scale your application into new regions with minimal code changes. However, given the diversity of MLS listing models, we also recognize that not every field can be normalized across all MLSs. To address this, we've introduced the "raw" fields feature.

This feature ensures that you still have access to MLS-specific fields that we don't map to our standardized data dictionary. The raw fields are original field names and values directly from the MLS, and they are hidden by default but can be easily accessed when needed.

Accessing Raw Fields via the Search Listings Endpoint

To access raw fields for each listing in your search results, simply include the fields=raw parameter in your request. This will return the raw object for each listing.

Example Request:

GET https://api.repliers.io/listings?fields=raw

Example Response:

{
    "listings": [
        {
            "raw": {
                "Acres": "50-99.99",
                "Addl_mo_fee": "",
                "Addr": "4968 Nigh Rd",
                "All_inc": "",
                "Apt_num": "",
                "Ass_year": "",
                "Bath_tot": "3",
                "Br": "4",
                "Br_plus": "",
                "Bsmt1_out": "None",
                "Bsmt2_out": "",
                "Cable": "",
                "Cac_inc": "",
                "Cd": "",
                "Central_vac": "",
                "Cndsold_xd": "",
                "Com_coopb": "2.0",
                "Comel_inc": "",
                "Comp_pts": "S"
            }
        }
    ]
}

Requesting Specific Raw Fields

If you are only interested in specific raw fields, you can request them individually. For example, to retrieve the Acres field:

Example Request:

GET https://api.repliers.io/listings?fields=raw.Acres

Example Response:

{
    "listings": [
        {
            "raw": {
                "Acres": "50-99.99"
            }
        }
    ]
}

Combining Raw Fields with Other Fields

You can also combine raw fields with other fields in your request. For example, to retrieve both the mlsNumber and Acres fields:

Example Request:

GET https://api.repliers.io/listings?fields=mlsNumber,raw.Acres

Example Response:

{
    "listings": [
        {
            "mlsNumber": "X9241188",
            "raw": {
                "Acres": "50-99.99"
            }
        }
    ]
}

Accessing Raw Fields via the Get A Single Listing Endpoint

When requesting details for a single listing, you can include raw fields by adding fields=raw to your request URL.

Example Request:

GET https://api.repliers.io/listings/X9241188?fields=raw

Example Response:

{
    "mlsNumber": "X9241188",
    "resource": "Property:2381",
    "status": "A",
    "class": "ResidentialProperty",
    "type": "Sale",
    "listPrice": "3334990.00",
    "listDate": "2024-08-25T00:00:00.000Z",
    "lastStatus": "New",
    "soldPrice": "0.00",
    "soldDate": null,
    "originalPrice": "3334990.00",
    "raw": {
        "Acres": "50-99.99",
        "Addl_mo_fee": "",
        "Addr": "4968 Nigh Rd",
        "All_inc": "",
        "Apt_num": "",
        "Ass_year": "",
        "Bath_tot": "3"
    }
}

Using Raw Fields in Aggregations

Raw fields can also be used with the aggregates parameter. This is useful for grouping possible values and obtaining aggregate counts.

Example Request:

To get a breakdown of the Laundry field:

GET https://api.repliers.io/listings?aggregates=raw.Laundry

{
    "aggregates": {
        "raw": {
            "Laundry": {
                "": 43580,
                "ensuite": 19383,
                "shared": 632,
                "in area": 582,
                "none": 510,
                "coin operated": 476,
                "set usage": 7
            }
        }
    }
}

You can also request multiple raw aggregates or combine raw aggregates with other fields:

Example Request:

GET https://api.repliers.io/listings?aggregates=raw.Laundry,raw.FoundationType,details.propertyType

Filtering by Raw Fields

You can filter listings by raw fields in your search queries. For example, to find listings where Laundry is "coin operated":

Example Request:

GET https://api.repliers.io/listings?raw.Laundry=coin operated

You can also combine raw field filters with other filters:

Example Request:

GET https://api.repliers.io/listings?raw.Laundry=coin operated&maxPrice=500000

Watch The Video: Raw MLS Data Access With Repliers

In this video, Co-founder Patrick Arlia provides a quick tutorial on how to work with raw data from the MLS:

https://www.loom.com/share/512930011fe94e30ad27d2a3419c65c9

Conclusion

The raw fields feature gives you the flexibility to access MLS-specific data that isn't normalized in our standard data dictionary. This powerful feature allows you to maintain compatibility with multiple MLSs without sacrificing access to the full range of listing data. Whether you're performing searches, retrieving single listings, aggregating data, or filtering results, raw fields provide the tools you need to get the job done.

If you have any questions or need further assistance, feel free to reach out to our support team. We're here to help!

Updated on: 29/11/2024