--- title: "(*BETA*) MLS Search API (v3)" method: POST path: "/v3/MLSSearch" --- # (*BETA*) MLS Search API (v3) `POST /v3/MLSSearch` ## Request body - object - `count` boolean - `listing_ids_only` boolean - `ids_only` boolean - `size` integer - `resultIndex` integer - `fields` string[] — ref: https://developer.realestateapi.com/reference/no-more-bloated-responses - `field_sections` string[] — ref: https://developer.realestateapi.com/reference/no-more-bloated-responses (Note: max allowable sections for MLS Search object response schema is 5; past that please use the MLS Detail Bulk API) - `sort` object - `name` string - `public` boolean — By default, no public record data will be returned. If this is set to "true" and your account has an active Starter, Growth, Pro, or Enterprise plan, then you can return the .public object or use the field selector options to return select fields from .public schema - `include_photos` boolean - `exclude` object[] - `and` object[] — initiate a compound query - `mls_board_code` string — Scope your searches by the MLS Region. MLS Plans are metered by regions of access. - `mls_board_name` string - `mls_number` string — Only works when accompanied by "mls_board_code" or "mls_board_name" - `city` string — Needs to be paired with "state" - `county` string — Needs to be paired with "state" - `state` string — Accepts 2 character state codes - `zip` string — Accepts 5 digit zip codes - `address` string — ONLY use with "radius" - `listing_id` string — ONLY use with "radius" - `assessor_id` string — ONLY use with "radius" - `apn` string — ONLY use with "radius" - `latitude` number, float — ONLY use with "longitude" + "radius" - `longitude` number, float — ONLY use with "latitude"+"radius" - `radius` number, float — Accepts values 1 to 100 - `polygon` object[] — Get a result set of listings inside your polygon shape (array of lat/lng pairs in objects). Can be applied with any other filters - `multi_polygon` object[] — Provide an array of polygon shapes to get results that appear in any of the given polgyons - `status` string — Primary status lookup field - `listing_date_min` string, date - `listing_date_max` string, date - `days_on_market_min` integer - `days_on_market_max` integer - `listing_property_type` string - `property_sub_type` string - `listing_price_min` integer - `listing_price_max` integer - `modification_timestamp_min` string, date - `modification_timestamp_max` string, date - `price_change_timestamp_min` string, date - `price_change_timestamp_max` string, date - `status_change_timestamp_min` string, date - `status_change_timestamp_max` string, date - `average_days_between_price_changes_min` integer - `average_days_between_price_changes_max` integer - `bathrooms` integer - `bathrooms_min` integer - `bathrooms_max` integer - `bedrooms` integer - `bedrooms_min` integer - `bedrooms_max` integer - `living_area_min` integer - `living_area_max` integer - `lot_size_min` integer - `lot_size_max` integer - `builder_model` string - `builder_name` string - `buyer_financing` string - `cooling` string - `cooling_type` string - `current_financing` string - `current_price_per_sqft_min` integer - `current_price_per_sqft_max` integer - `delta_from_last_list_price_min` integer - `delta_from_last_list_price_max` integer - `delta_from_original_list_price_min` integer - `delta_from_original_list_price_max` integer - `development_status` string - `electric` string - `exterior_features` string - `fencing` string - `fencing_type` string - `fireplaces_min` integer - `fireplaces_max` integer - `flooring` string - `flooring_type` string - `garage_spaces_min` integer - `garage_spaces_max` integer - `has_appliances` boolean - `has_basement` boolean - `has_builder_data` boolean - `has_colisting_data` boolean - `has_coselling_data` boolean - `has_exterior_features` boolean - `has_fencing` boolean - `has_fireplace` boolean - `has_garage` boolean - `has_green_data` boolean - `has_green_energy_efficient` boolean - `has_green_energy_generation` boolean - `has_green_indoor_air_quality` boolean - `has_green_water_conservation` boolean - `has_hoa` boolean - `has_inclusions` boolean - `has_linked_listings` boolean - `has_matterport` boolean - `has_open_houses` boolean - `has_past_listings` boolean - `has_photos` boolean - `has_pool` boolean - `has_price_changes` boolean - `has_schools` boolean - `has_security_features` boolean - `has_seller_data` boolean - `has_special_listing_conditions` boolean - `has_status_changes` boolean - `has_upcoming_open_houses` boolean - `has_virtual_tour` boolean - `heating` string - `heating_type` string - `hoa_amenities` string - `hoa_association_name` string - `hoa_association_name2` string - `hoa_fee_min` string - `hoa_fee_max` string - `hoa_fee2_min` string - `hoa_fee2_max` string - `hoa_fee_frequency` string - `hoa_fee_frequency2` string - `is_city_view` boolean - `is_mountain_view` boolean - `is_park_view` boolean - `is_water_front` boolean - `is_water_view` boolean - `last_price_change_delta_min` integer - `last_price_change_delta_max` integer - `new_construction` boolean - `new_list_price_min` integer - `new_list_price_max` integer - `number_of_price_changes_min` integer - `number_of_price_changes_max` integer - `number_of_status_changes_min` integer - `number_of_status_changes_max` integer - `open_house_date_min` string, date - `open_house_date_max` string, date - `original_listing_price_min` integer - `original_listing_price_max` integer - `original_to_current_listing_price_delta_min` integer - `original_to_current_listing_price_delta_max` integer - `patio_features` string - `previous_list_price_min` integer - `previous_list_price_max` integer - `previous_status` string - `price_per_sqft_min` integer - `price_per_sqft_max` integer - `property_condition` string - `roof` string - `roof_type` string - `school_district` string - `security_features` string - `sewer` string - `sewer_type` string - `sold` boolean - `sold_date_min` string, date - `sold_date_max` string, date - `sold_price_min` integer - `sold_price_max` integer - `stories` integer - `subdivision` string - `water_source` string - `window_features` string - `year_built` integer - `zoning` string - `listing_agent_email` string - `listing_agent_phone` string - `listing_agent_name` string - `listing_agent_mls_code` string - `listing_office_address` string - `listing_office_mls_code` string - `listing_office_email` string - `listing_office_phone` string - `listing_price_low_min` integer - `listing_price_low_max` integer - `listing_price_high_min` integer - `listing_price_high_max` integer - `selling_agent_email` string - `selling_agent_phone` string - `selling_agent_mls_code` string - `selling_agent_name` string - `selling_office_email` string - `selling_office_phone` string - `selling_office_name` string - `selling_office_mls_code` string - `colisting_agent_email` string - `colisting_agent_mls_code` string - `colisting_agent_name` string - `colisting_agent_phone` string - `colisting_office_email` string - `colisting_office_mls_code` string - `colisting_office_name` string - `colisting_office_phone` string - `coselling_agent_email` string - `coselling_agent_mls_code` string - `coselling_agent_name` string - `coselling_agent_phone` string - `coselling_office_email` string - `coselling_office_mls_code` string - `coselling_office_name` string - `coselling_office_phone` string - `standard_status_derived` boolean - `closed_date_derived` boolean - `is_listed` boolean - `listing_contract_date_derived` boolean - `sold_derived` boolean - `sold_price_derived` boolean - `stale_check_affected` boolean ## Response `200` --- [API](https://skmtc.net/realestateapi/apis/property-apis.md) · [All operations](https://skmtc.net/realestateapi/apis/property-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/realestateapi/property-apis/versions/8e1eee264b55/schema)