MLS Search

MLS Search finds listings matching your criteria across status, price, days on market, dates, and home characteristics. The date filters are what daily sync jobs are built on — filter on modification timestamp to pick up everything that changed since your last run.

POST/v2/MLSSearch

Search listings

Request attributes

  • Name
    count
    Type
    boolean
    Description

    Return only the number of matching listings.

  • Name
    size
    Type
    integer
    Description

    Results per page.

  • Name
    resultIndex
    Type
    integer
    Description

    Offset to start from.

  • Name
    listing_ids_only
    Type
    boolean
    Description

    Return only listing IDs, for bulk enrichment jobs.

  • Name
    ids_only
    Type
    boolean
    Description

    Return only property IDs, to enrich with public-record data.

  • Name
    include_photos
    Type
    boolean
    Description

    Include listing media in the response.

  • Name
    latest_only
    Type
    boolean
    Description

    Return only the most recent listing per property.

  • Name
    sort
    Type
    object
    Description

    Sort clause over any sortable listing field.

  • Name
    listing_date
    Type
    string
    Description

    Filter on initial listing date, YYYY-MM-DD.

  • Name
    sold_date
    Type
    string
    Description

    Filter on the date the sale was reported to the MLS.

  • Name
    contract_date
    Type
    string
    Description

    Filter on the date the listing went under contract.

  • Name
    modification_timestamp
    Type
    string
    Description

    Filter on last modification — the basis for daily update jobs.

  • Name
    price_change
    Type
    string
    Description

    Filter on price change activity.

  • Name
    listing_price
    Type
    string
    Description

    Filter on current listing price.

  • Name
    sold_price
    Type
    string
    Description

    Filter on sold price.

  • Name
    bedrooms
    Type
    string
    Description

    Filter on bedroom count.

  • Name
    bathrooms
    Type
    string
    Description

    Filter on bathroom count.

  • Name
    living_area
    Type
    string
    Description

    Filter on living area.

  • Name
    lot_size
    Type
    string
    Description

    Filter on lot size.

  • Name
    year_built
    Type
    string
    Description

    Filter on year built.

  • Name
    mls_number
    Type
    string
    Description

    Find one listing by its MLS number.

Request

POST
/v2/MLSSearch
curl -X POST https://api.realestateapi.com/v2/MLSSearch \
  -H "x-api-key: $REALESTATEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city": "Austin", "state": "TX", "count": true}'

The full response schema for this endpoint — every field and enum — lives in the canonical reference. That content has not been ported to this site yet.

Was this page helpful?