Search Listings

Search active MLS listings by location, price, beds, baths, property type, and keywords with pagination. Requires an OAuth access token.

GET/v1/listings

Authentication

OAuthAuthorization: Bearer

Requires OAuth access token (scope: listings)

Query Parameters

PropertyTypeenum

required

Sale: Residential, Residential Income, Land, Commercial Sale, Business Opportunity. Rent: Residential Lease, Commercial Lease.

Default:Residential

ResidentialResidential IncomeLandLand/Boat DocksCommercial SaleBusiness OpportunityResidential LeaseCommercial Lease

Subtypesstring

optional

Comma-separated. Residential: Single Family Residence, Condominium, Townhouse, Villa, Condo - Hotel, 1/2 Duplex, Mobile Home. Residential Lease: Single Family Residence, Condominium, Townhouse, Villa, Apartment, Efficiency.

Statusenum

required

Active, Pending, Closed (= Sold/Rented), Active Under Contract

Default:Active

ActivePendingClosedActive Under Contract

Citystring

optional

Filter by city name

PostalCodestring

optional

Filter by postal code

StreetNumberstring

optional

Street number for address search

StreetNamestring

optional

Street name for address search

UnitNumberstring

optional

Unit/apartment number

BuildingNamestring

optional

Building name (phrase match)

SubdivisionNamestring

optional

Subdivision name

MinListPricenumber

optional

Price range filter

MaxListPricenumber

optional

Price range filter

MinBedroomsTotalnumber

optional

Bedrooms range (0 = Studio)

MaxBedroomsTotalnumber

optional

Bedrooms range (0 = Studio)

MinBathroomsnumber

optional

Bathrooms range

MaxBathroomsnumber

optional

Bathrooms range

MinLivingAreanumber

optional

Living area range in sqft

MaxLivingAreanumber

optional

Living area range in sqft

MinLotSizenumber

optional

Lot size range in sqft

MaxLotSizenumber

optional

Lot size range in sqft

MinYearBuiltnumber

optional

Year built range

MaxYearBuiltnumber

optional

Year built range

MinAssociationFeenumber

optional

Minimum monthly HOA fee

MaxAssociationFeenumber

optional

Maximum monthly HOA fee

Poolboolean

optional

Private pool

Waterfrontboolean

optional

Waterfront property

Penthouseboolean

optional

Penthouse units

Furnishedboolean

optional

Furnished property

PetsAllowedboolean

optional

Pets allowed

Gatedboolean

optional

Gated community

TennisCourtboolean

optional

Tennis court

GolfCourseboolean

optional

Golf course property

BoatDockboolean

optional

Boat dock access

ShortSaleboolean

optional

Short sale listing

SeasonalRentalsboolean

optional

Short term lease

SeniorCommunitystring

optional

55+ community: true (include only), exclude (exclude), or omit

Agentstring

optional

Filter by agent MLS ID

Brokerstring

optional

Filter by broker/office MLS ID

MaxDaysOnMarketnumber

optional

Maximum days on market (e.g., 7, 30, 90)

Sincestring

optional

ISO 8601 timestamp. Only listings added after this date (e.g., 2026-03-01T00:00:00Z)

Sortstring

optional

Sort: -listprice, listprice, -listdate, beds, baths

Default:-listprice

Offsetnumber

optional

Skip results for pagination

Default:0

Limitnumber

optional

Results per page (max 50)

Default:20

Responses

200Success

application/json

totalnumber

Total matching listings count

offsetnumber

Current pagination offset

limitnumber

Results per page

listingsarray

Array of listing objects

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/listings?City=Miami&MinListPrice=500000&MinBedroomsTotal=2&Pool=true&Limit=10" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response200 OK

{
  "total": 1234,
  "offset": 0,
  "limit": 20,
  "listings": [
    {
      "ListingId": "A11855701",
      "ListPrice": 895000,
      "PreviousListPrice": 950000,
      "BedroomsTotal": 3,
      "BathroomsTotalInteger": 2,
      "LivingArea": 1850,
      "LotSizeSquareFeet": 5000,
      "City": "Miami",
      "StateOrProvince": "FL",
      "PostalCode": "33131",
      "StreetNumber": "1010",
      "StreetDirPrefix": "NW",
      "StreetName": "Brickell Ave",
      "UnitNumber": "1113",
      "StandardStatus": "Active",
      "PropertyType": "Residential",
      "SubdivisionName": "Brickell",
      "OriginalEntryTimestamp": "2024-06-15T12:00:00Z",
      "CloseDate": null,
      "LeaseTerm": null,
      "LeaseAmountFrequency": null,
      "image": "https://photos.mls.com/photo1.jpg",
      "coordinates": {
        "lng": -80.1918,
        "lat": 25.7617
      }
    }
  ]
}