> ## Documentation Index
> Fetch the complete documentation index at: https://docs.propertydata.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Properties For Sale

> Search Properties For Sale



## OpenAPI

````yaml api-reference/realtor/openapi.json get /api/v1/search/for-sale
openapi: 3.1.0
info:
  title: US Red Property Data
  description: US Red Property Data Documentation
  version: 1.0.0
servers:
  - url: https://us-red-property-data.p.rapidapi.com
    description: RapiAPI
security: []
paths:
  /api/v1/search/for-sale:
    get:
      tags:
        - Search
      summary: Search Properties For Sale
      description: Search Properties For Sale
      operationId: getApiV1SearchFor-sale
      parameters:
        - in: query
          name: location
          schema:
            type: string
            minLength: 1
            description: Location
            example: '20002'
          required: true
        - in: query
          name: page
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Page number for pagination
            default: 1
            example: 1
          required: false
        - in: query
          name: sort_by
          schema:
            type: string
            enum:
              - relevant_listings
              - newest_listings
              - lowest_price
              - highest_price
              - year_built
              - open_house_date
              - recently_reduced
              - largest_sqft
              - lot_size
              - photo_count
            description: |
              Sort results by the specified criteria

              - `relevant_listings`: Relevant listings
              - `newest_listings`: Newest listings
              - `lowest_price`: Lowest price
              - `highest_price`: Highest price
              - `year_built`: Year built
              - `open_house_date`: Open house date
              - `recently_reduced`: Recently reduced
              - `largest_sqft`: Largest sqft
              - `lot_size`: Lot size
              - `photo_count`: Photo count
            default: relevant_listings
            example: relevant_listings
          required: false
        - in: query
          name: list_price_range
          schema:
            type: string
            description: |-
              list_price_range filter in format **min,max**

              Example `50000,1000000` means price from $50,000 to $1,000,000
            example: 50000,1000000
          required: false
        - in: query
          name: is_price_reduced
          schema:
            type: boolean
            description: Price reduced
            example: true
          required: false
        - in: query
          name: is_builder_promotions
          schema:
            type: boolean
            description: Builder promotions
            example: true
          required: false
        - in: query
          name: monthly_payment_range
          schema:
            type: string
            description: |-
              monthly_payment_range filter in format **min,max**

              Example `50000,1000000` means price from $50,000 to $1,000,000
            example: 50000,1000000
          required: false
        - in: query
          name: monthly_down_payment
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Down payment
            example: 1000
          required: false
        - in: query
          name: number_of_bedrooms
          schema:
            type: integer
            exclusiveMinimum: 0
            description: >-
              Filter by minimum number of bedrooms. The value represents the
              lower bound. For example, if `1` is provided, the query will
              return properties with 1 or more bedrooms (bedrooms >= 1)
            example: 1
          required: false
        - in: query
          name: number_of_bathrooms
          schema:
            type: integer
            exclusiveMinimum: 0
            description: >-
              Filter by minimum number of bathrooms. The value represents the
              lower bound. For example, if `1` is provided, the query will
              return properties with 1 or more bathrooms (bathrooms >= 1)
            example: 1
          required: false
        - in: query
          name: home_types
          schema:
            type: string
            description: |
              Filter listings by home type

              You can use one or multiple values separated by commas `,`


              - `house`: House
              - `condo`: Condo
              - `townhome`: Townhome
              - `multi_family`: Multi Family
              - `mobile`: Mobile
              - `farm`: Farm
              - `land`: Land
            example: house,condo
          required: false
        - in: query
          name: status
          schema:
            type: string
            description: |
              Filter listings by status

              You can use one or multiple values separated by commas `,`


              - `active`: Active
              - `pending_or_contingent`: Pending/contingent
            default: active,pending_or_contingent
          required: false
        - in: query
          name: type
          schema:
            type: string
            description: |
              Filter listings by type

              You can use one or multiple values separated by commas `,`


              - `existing_homes`: Existing homes
              - `foreclosures`: Foreclosures
              - `new_construction`: New construction
              - `55_plus_community`: 55+ community
            default: existing_homes,foreclosures,new_construction,55_plus_community
          required: false
        - in: query
          name: days_on_realtor
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Days on Realtor.com
            example: 30
          required: false
        - in: query
          name: square_feet_range
          schema:
            type: string
            description: |-
              square_feet_range filter in format **min,max**

              Example `500,2000` square feet from 500 to 2000
            example: 500,2000
          required: false
        - in: query
          name: lot_size_range
          schema:
            type: string
            description: |-
              lot_size_range filter in format **min,max**

              Example: `1000,2000` lot size from 1000 sqft to 2000 sqft
            example: 1000,2000
          required: false
        - in: query
          name: year_built_range
          schema:
            type: string
            description: |-
              year_built_range filter in format **min,max**

              Example: `2015,2020` year built from 2015 to 2020
            example: 2015,2020
          required: false
        - in: query
          name: max_hoa_fees_per_month
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Max HOA Fees per month
            example: 500
          required: false
        - in: query
          name: garage
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Garage
            example: 1
          required: false
        - in: query
          name: is_single_story_only
          schema:
            type: boolean
            description: Single-story only
            example: true
          required: false
        - in: query
          name: home_features
          schema:
            type: string
            description: |
              Filter listings by home features

              You can use one or multiple values separated by commas `,`
            example: Pool,Lake view
          required: false
        - in: query
          name: interior
          schema:
            type: string
            description: |
              Filter listings by interior

              You can use one or multiple values separated by commas `,`


              - `disability_features`: Accessibility
              - `basement`: Basement
              - `central_air`: Central Air
              - `central_heat`: Central Heat
              - `den_or_office`: Den/office
              - `dining_room`: Dining room
              - `elevator`: Elevator
              - `energy_efficient`: Energy efficient
              - `family_room`: Family room
              - `fireplace`: Fireplace
              - `forced_air`: Forced air
              - `game_room`: Game room
              - `hardwood_floors`: Hardwood floors
              - `washer_dryer`: In-home laundry
            example: disability_features,basement
          required: false
        - in: query
          name: exterior
          schema:
            type: string
            description: |
              Filter listings by exterior

              You can use one or multiple values separated by commas `,`


              - `carport`: Carport
              - `corner_lot`: Corner lot
              - `cul_de_sac`: Cul-de-sac
              - `golf_course_lot_or_frontage`: Golf course lot
              - `horse_facilities`: Horse facility
              - `swimming_pool`: Pool
              - `rv_or_boat_parking`: RV / boat parking
              - `spa_or_hot_tub`: Spa / hot tub
            example: carport,corner_lot
          required: false
        - in: query
          name: views
          schema:
            type: string
            description: |
              Filter listings by views

              You can use one or multiple values separated by commas `,`


              - `city_view`: City view
              - `golf_course_view`: Golf course view
              - `hill_or_mountain_view`: Hill / mtn view
              - `lake_view`: Lake view
              - `ocean_view`: Ocean view
              - `river_view`: River view
              - `waterfront`: Waterfront
            example: city_view,golf_course_view
          required: false
        - in: query
          name: community
          schema:
            type: string
            description: |
              Filter listings by community

              You can use one or multiple values separated by commas `,`


              - `senior_community`: 55+ community
              - `community_boat_facilities`: Boat facility
              - `community_clubhouse`: Clubhouse
              - `community_golf`: Golf course
              - `community_horse_facilities`: Horse facility
              - `community_park`: Park
              - `community_swimming_pool`: Pool
              - `recreation_facility`: Recreation facility
              - `community_security_features`: Security feature
              - `community_spa_or_hot_tub`: Spa / hot tub
              - `tennis_court`: Tennis court
            example: senior_community,community_boat_facilities
          required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  cost:
                    type: number
                    description: Cost of the request
                    example: 1
                  total:
                    type: number
                    description: Total number of properties matching the search criteria
                    example: 792
                  has_more:
                    type: boolean
                    description: Whether there are more data to fetch
                    example: true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        property_id:
                          type: string
                          description: ''
                          example: '9899634262'
                        list_price:
                          type: number
                          description: ''
                          example: 524900
                        rmn_listing_attribution:
                          type: boolean
                          description: ''
                          example: false
                        search_promotions:
                          type: 'null'
                          description: ''
                          example: null
                        primary_photo:
                          type: object
                          properties:
                            href:
                              type: string
                              description: ''
                              example: >-
                                https://ap.rdcpix.com/65b2ea0ff9143964d1a6eae92c18d4efl-m3392567331s.jpg
                          description: ''
                        listing_id:
                          type: string
                          description: ''
                          example: '2989928263'
                        matterport:
                          type: boolean
                          description: ''
                          example: true
                        virtual_tours:
                          type: 'null'
                          description: ''
                          example: null
                        status:
                          type: string
                          description: ''
                          example: for_sale
                        products:
                          type: object
                          properties:
                            products:
                              type: array
                              items:
                                type: string
                              description: ''
                              example:
                                - core.agent
                                - co_broke
                            brand_name:
                              type: string
                              description: ''
                              example: basic_opt_in
                          description: ''
                        source:
                          type: object
                          properties:
                            id:
                              type: string
                              description: ''
                              example: PHPA
                            name:
                              type: string
                              description: ''
                              example: BrightMLS
                            type:
                              type: string
                              description: ''
                              example: mls
                            spec_id:
                              type: 'null'
                              description: ''
                              example: null
                            plan_id:
                              type: 'null'
                              description: ''
                              example: null
                            listing_id:
                              type: string
                              description: ''
                              example: DCDC2239288
                          description: ''
                        lead_attributes:
                          type: object
                          properties:
                            show_contact_an_agent:
                              type: boolean
                              description: ''
                              example: true
                            market_type:
                              type: string
                              description: ''
                              example: choice
                            lead_type:
                              type: string
                              description: ''
                              example: co_broke
                            is_veterans_united_eligible:
                              type: boolean
                              description: ''
                              example: true
                          description: ''
                        community:
                          type: 'null'
                          description: ''
                          example: null
                        permalink:
                          type: string
                          description: ''
                          example: >-
                            845-19th-St-NE-Apt-10_Washington_DC_20002_M98996-34262
                        price_reduced_amount:
                          type: 'null'
                          description: ''
                          example: null
                        description:
                          type: object
                          properties:
                            name:
                              type: 'null'
                              description: ''
                              example: null
                            beds:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 2
                            baths_consolidated:
                              type: string
                              description: ''
                              example: '2'
                            sqft:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 1133
                            lot_sqft:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            baths_max:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            baths_min:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            beds_min:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            beds_max:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            sqft_min:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            sqft_max:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            type:
                              type: string
                              description: ''
                              example: condos
                            sub_type:
                              type: string
                              description: ''
                              example: condo
                            sold_price:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            sold_date:
                              type: 'null'
                              description: ''
                              example: null
                            year_built:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 2025
                            garage:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                          description: ''
                        location:
                          type: object
                          properties:
                            street_view_url:
                              type: string
                              description: ''
                              example: >-
                                https://maps.googleapis.com/maps/api/streetview?channel=rdc-streetview&client=gme-movesalesinc&location=845%2019th%20St%20NE%20Apt%2010%2C%20Washington%2C%20DC%2020002&size=640x480&source=outdoor&signature=FhoF9uG4Lit_bKsBgmYoVr5cvVo=
                            address:
                              type: object
                              properties:
                                line:
                                  type: string
                                  description: ''
                                  example: 845 19th St NE Apt 10
                                postal_code:
                                  type: string
                                  description: ''
                                  example: '20002'
                                state:
                                  type: string
                                  description: ''
                                  example: District of Columbia
                                state_code:
                                  type: string
                                  description: ''
                                  example: DC
                                city:
                                  type: string
                                  description: ''
                                  example: Washington
                                coordinate:
                                  type: object
                                  properties:
                                    lat:
                                      type: number
                                      description: ''
                                      example: 38.901192
                                    lon:
                                      type: number
                                      description: ''
                                      example: -76.975883
                                  description: ''
                              description: ''
                            county:
                              type: object
                              properties:
                                name:
                                  type: string
                                  description: ''
                                  example: District of Columbia
                                fips_code:
                                  type:
                                    - string
                                    - 'null'
                                  description: ''
                                  example: null
                              description: ''
                          description: ''
                        open_houses:
                          type: 'null'
                          description: ''
                          example: null
                        branding:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                description: ''
                                example: Office
                              name:
                                type: string
                                description: ''
                                example: Mcwilliams/Ballard Inc.
                              photo:
                                type:
                                  - string
                                  - 'null'
                                description: ''
                                example: null
                          description: ''
                        flags:
                          type: object
                          properties:
                            is_coming_soon:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_new_listing:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: false
                            is_price_reduced:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_foreclosure:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_new_construction:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: true
                            is_pending:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_contingent:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_auction:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_fractionally_owned:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_non_deeded:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                          description: ''
                        list_date:
                          type: string
                          description: ''
                          example: '2026-01-02T00:28:51.000000Z'
                        photos:
                          type: array
                          items:
                            type: object
                            properties:
                              href:
                                type: string
                                description: ''
                                example: >-
                                  https://ap.rdcpix.com/65b2ea0ff9143964d1a6eae92c18d4efl-m3392567331s.jpg
                          description: ''
                        advertisers:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                description: ''
                                example: seller
                              fulfillment_id:
                                type: string
                                description: ''
                                example: '1473840'
                              name:
                                type: string
                                description: ''
                                example: Steve Swank
                              builder:
                                type:
                                  - string
                                  - 'null'
                                description: ''
                                example: null
                              email:
                                type: string
                                description: ''
                                example: steve.swank@compass.com
                              office:
                                type: object
                                properties:
                                  name:
                                    type: string
                                    description: ''
                                    example: Mcwilliams/Ballard Inc.
                                description: ''
                              phones:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    number:
                                      type: string
                                      description: ''
                                      example: '2025530964'
                                description: ''
                          description: ''
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Invalid API key. Go to https://docs.rapidapi.com/docs/keys
                      for more info.
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: You are not subscribed to this API.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: 'Request failed with status 500: Internal Server Error'
                  status_code:
                    type: number
                    example: 500
                  cost:
                    type: number
                    example: 0
                  explain:
                    type: string
                    example: >-
                      Oops, it looks like there was an issue processing your
                      request. Don't worry, you won't be charged for this
                      request
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: Rapid API Key

````