> ## 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 Rent

> Search Properties For Rent



## OpenAPI

````yaml api-reference/realtor/openapi.json get /api/v1/search/for-rent
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-rent:
    get:
      tags:
        - Search
      summary: Search Properties For Rent
      description: Search Properties For Rent
      operationId: getApiV1SearchFor-rent
      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:
              - best_match
              - recently_added
              - highest_price
              - lowest_price
            description: |
              Sort results by the specified criteria

              - `best_match`: Best match
              - `recently_added`: Recently added
              - `highest_price`: Highest price
              - `lowest_price`: Lowest price
            default: best_match
            example: best_match
          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: property_type
          schema:
            type: string
            description: |
              Filter listings by property type

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


              - `apartment`: Apartment
              - `townhome`: Townhome
              - `condo`: Condo
              - `single_family`: Single family
            example: apartment,townhome
          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: move_in_by
          schema:
            type: string
            pattern: ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$
            description: Desired move-in date. Format `YYYY-MM-DD` (ISO 8601)
            example: '2026-01-31'
          required: false
        - in: query
          name: pet_friendly
          schema:
            type: string
            description: |
              Filter listings by pet friendly

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


              - `cats`: Cats OK
              - `dogs`: Dogs OK
            example: cats,dogs
          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: is_accepts_online_applications
          schema:
            type: boolean
            description: Accepts online applications
            example: true
          required: false
        - in: query
          name: is_3d_tours
          schema:
            type: boolean
            description: 3D Tours
            example: true
          required: false
        - in: query
          name: unit_features
          schema:
            type: string
            description: |
              Filter listings by unit features

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


              - `washer_dryer`: Washer / dryer
              - `central_air`: Central air
            example: washer_dryer,central_air
          required: false
        - in: query
          name: community_features
          schema:
            type: string
            description: |
              Filter listings by community features

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


              - `garage_1_or_more`: Parking
              - `community_gym`: Gym
              - `community_swimming_pool`: Pool(s)
              - `laundry_room`: Laundry room
            example: garage_1_or_more,community_gym
          required: false
        - in: query
          name: keyword_search
          schema:
            type: string
            description: |
              Filter listings by keyword search

              You can use one or multiple values separated by commas `,`
            example: Pool,Lake view
          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: '9525905454'
                        listing_id:
                          type: string
                          description: ''
                          example: '2966802712'
                        list_price:
                          type:
                            - number
                            - 'null'
                          description: ''
                          example: null
                        list_price_max:
                          type: number
                          description: ''
                          example: 2353
                        list_price_min:
                          type: number
                          description: ''
                          example: 1325
                        permalink:
                          type: string
                          description: ''
                          example: >-
                            1676-Maryland-Ave-NE_Washington_DC_20002_M95259-05454
                        price_reduced_amount:
                          type: 'null'
                          description: ''
                          example: null
                        matterport:
                          type: boolean
                          description: ''
                          example: false
                        has_specials:
                          type: boolean
                          description: ''
                          example: true
                        application_url:
                          type:
                            - string
                            - 'null'
                          description: ''
                          example: null
                        status:
                          type: string
                          description: ''
                          example: for_rent
                        list_date:
                          type: string
                          description: ''
                          example: '2024-04-26T18:46:28.000000Z'
                        available_date_change_timestamp:
                          type: string
                          description: ''
                          example: '2026-02-15T01:17:05.394'
                        branding:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                description: ''
                                example: Office
                              photo:
                                type:
                                  - string
                                  - 'null'
                                description: ''
                                example: null
                              name:
                                type:
                                  - string
                                  - 'null'
                                description: ''
                                example: null
                          description: ''
                        source:
                          type: object
                          properties:
                            id:
                              type: string
                              description: ''
                              example: ZILL
                            community_id:
                              type: number
                              description: ''
                              example: 4352806
                            type:
                              type: string
                              description: ''
                              example: community
                            feed_type:
                              type: string
                              description: ''
                              example: Syndicator Community
                          description: ''
                        details:
                          type: array
                          items:
                            type: object
                            properties:
                              category:
                                type: string
                                description: ''
                                example: Community Features
                              text:
                                type: array
                                items:
                                  type: string
                                description: ''
                                example:
                                  - Barbecue Area
                                  - Bicycle storage
                                  - Cable/Internet Ready
                          description: ''
                        products:
                          type: object
                          properties:
                            products:
                              type: array
                              items:
                                type: string
                              description: ''
                              example:
                                - co_broke
                                - rentals_cost_per_lead_hybrid
                            brand_name:
                              type: string
                              description: ''
                              example: basic_opt_in
                          description: ''
                        rentals_application_eligibility:
                          type: object
                          properties:
                            estimated_status:
                              type: string
                              description: ''
                              example: BLOCKED
                          description: ''
                        flags:
                          type: object
                          properties:
                            is_pending:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: null
                            is_new_listing:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: false
                            has_new_availability:
                              type:
                                - boolean
                                - 'null'
                              description: ''
                              example: true
                          description: ''
                        photos:
                          type: array
                          items:
                            type: object
                            properties:
                              href:
                                type: string
                                description: ''
                                example: >-
                                  https://ar.rdcpix.com/270ee3cad0607d29b04dc1d9c221146cc-f2193502019s.jpg
                          description: ''
                        primary_photo:
                          type: object
                          properties:
                            href:
                              type: string
                              description: ''
                              example: >-
                                https://ar.rdcpix.com/270ee3cad0607d29b04dc1d9c221146cc-f2193502019s.jpg
                          description: ''
                        search_promotions:
                          type: 'null'
                          description: ''
                          example: null
                        virtual_tours:
                          type: 'null'
                          description: ''
                          example: null
                        lead_attributes:
                          type: object
                          properties:
                            lead_type:
                              type: string
                              description: ''
                              example: rental_go_direct
                            is_premium_ldp:
                              type: boolean
                              description: ''
                              example: false
                            is_schedule_a_tour:
                              type: boolean
                              description: ''
                              example: false
                          description: ''
                        pet_policy:
                          type: object
                          properties:
                            cats:
                              type: boolean
                              description: ''
                              example: true
                            dogs:
                              type: boolean
                              description: ''
                              example: true
                            dogs_small:
                              type: boolean
                              description: ''
                              example: false
                            dogs_large:
                              type: boolean
                              description: ''
                              example: false
                          description: ''
                        description:
                          type: object
                          properties:
                            beds:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            beds_max:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 2
                            beds_min:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 0
                            baths_min:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 1
                            baths_max:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 2
                            baths_consolidated:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            baths:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            sqft:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: null
                            sqft_max:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 1091
                            sqft_min:
                              type:
                                - number
                                - 'null'
                              description: ''
                              example: 459
                            name:
                              type:
                                - string
                                - 'null'
                              description: ''
                              example: Union Heights
                            sub_type:
                              type:
                                - string
                                - 'null'
                              description: ''
                              example: null
                            type:
                              type:
                                - string
                                - 'null'
                              description: ''
                              example: apartment
                          description: ''
                        other_listings:
                          type: object
                          properties:
                            rdc:
                              type: array
                              items:
                                type: object
                                properties:
                                  listing_id:
                                    type: string
                                    description: ''
                                    example: '2966802712'
                                  status:
                                    type: string
                                    description: ''
                                    example: for_rent
                          description: ''
                        advertisers:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                description: ''
                                example: management
                              office:
                                type: object
                                properties:
                                  name:
                                    type: string
                                    description: ''
                                    example: Greystar
                                description: ''
                              rental_management:
                                type:
                                  - string
                                  - 'null'
                                description: ''
                                example: null
                          description: ''
                        location:
                          type: object
                          properties:
                            address:
                              type: object
                              properties:
                                line:
                                  type: string
                                  description: ''
                                  example: 1676 Maryland Ave NE
                                city:
                                  type: string
                                  description: ''
                                  example: Washington
                                coordinate:
                                  type: object
                                  properties:
                                    lat:
                                      type: number
                                      description: ''
                                      example: 38.901192
                                    lon:
                                      type: number
                                      description: ''
                                      example: -76.975883
                                country:
                                  type: string
                                  description: ''
                                  example: USA
                                state_code:
                                  type: string
                                  description: ''
                                  example: DC
                                postal_code:
                                  type: string
                                  description: ''
                                  example: '20002'
                              required:
                                - coordinate
                              description: ''
                            county:
                              type: object
                              properties:
                                name:
                                  type: string
                                  description: ''
                                  example: District of Columbia
                              description: ''
                          description: ''
                        units:
                          type: array
                          items:
                            type: object
                            properties:
                              availability:
                                type: object
                                properties:
                                  date:
                                    type: string
                                    description: ''
                                    example: '2026-02-18'
                                description: ''
                              description:
                                type: object
                                properties:
                                  baths_consolidated:
                                    type: 'null'
                                    description: ''
                                    example: null
                                  baths:
                                    type: number
                                    description: ''
                                    example: 2
                                  beds:
                                    type: number
                                    description: ''
                                    example: 2
                                  sqft:
                                    type: number
                                    description: ''
                                    example: 985
                                description: ''
                              list_price:
                                type: number
                                description: ''
                                example: 2054
                          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

````