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

# Get Agent For Sale

> Get Agent For Sale



## OpenAPI

````yaml api-reference/zillow/openapi.json get /api/v1/agent/for-sale
openapi: 3.1.0
info:
  title: US Property Data
  description: US Property Data Documentation
  version: 1.0.0
servers:
  - url: https://us-property-data.p.rapidapi.com
    description: RapiAPI
security: []
paths:
  /api/v1/agent/for-sale:
    get:
      tags:
        - Agent
      summary: Get Agent For Sale
      description: Get Agent For Sale
      operationId: getApiV1AgentFor-sale
      parameters:
        - in: query
          name: zuid
          schema:
            type: string
            description: >-
              Agent unique ID (ZUID). You can retrieve this ZUID by using the
              agent screen name from the Get Agent Detail endpoint
            example: X1-ZUyy58njdzkphl_aqadk
          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: include_team
          schema:
            type: boolean
            description: >-
              Indicates whether to include agent teams when retrieving agents
              for sale listings
            default: true
            example: true
          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 available for sale matching the
                      current query
                    example: 23
                  has_more:
                    type: boolean
                    description: Whether there are more data to fetch
                    example: true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        zpid:
                          type: number
                          description: Unique Zillow property ID
                          example: 12619667
                        home_type:
                          type: string
                          description: Type of the property
                          example: singleFamily
                        address:
                          type: object
                          properties:
                            line1:
                              type: string
                              description: Street address of the property
                              example: 60 Beech Dr
                            line2:
                              type: string
                              description: Full secondary address line (city, state, ZIP)
                              example: Stafford, VA 22556
                            city:
                              type: string
                              description: City where the property is located
                              example: Stafford
                            stateOrProvince:
                              type: string
                              description: State or province of the property
                              example: VA
                            postalCode:
                              type: string
                              description: Postal or ZIP code
                              example: '22556'
                        bedrooms:
                          type: number
                          description: Number of bedrooms in the property
                          example: 3
                        bathrooms:
                          type: number
                          description: Number of bathrooms in the property
                          example: 2
                        openHouses:
                          type: string
                          description: Open house schedule or information (if available)
                          example: ''
                        hasOpenHouse:
                          type: boolean
                          description: >-
                            Indicates whether the property currently has an open
                            house
                          example: false
                        primary_photo_url:
                          type: string
                          description: URL of the primary listing image
                          example: >-
                            https://photos.zillowstatic.com/fp/b2f5474549ee4801bffb599dbbe653b0-a_a.jpg
                        price:
                          type: number
                          description: Listing price of the property
                          example: 400000
                        price_currency:
                          type: string
                          description: Currency of the listing price
                          example: usd
                        status:
                          type: string
                          description: Raw listing status code
                          example: fsba
                        latitude:
                          type: number
                          description: Latitude coordinate of the property location
                          example: 38.49418
                        longitude:
                          type: number
                          description: Longitude coordinate of the property location
                          example: -77.54165
                        brokerage_name:
                          type: string
                          description: Name of the brokerage representing the listing
                          example: KW Metro Center
                        home_marketing_status:
                          type: string
                          description: Current marketing status of the home
                          example: active
                        home_marketing_type:
                          type: string
                          description: Marketing type of the listing
                          example: forSale
                        has_vr_model:
                          type: boolean
                          description: Indicates whether the listing includes a 3D/VR model
                          example: false
                        listing_url:
                          type: string
                          description: Relative URL to the property detail page on Zillow
                          example: >-
                            /homedetails/60-Beech-Dr-Stafford-VA-22556/12619667_zpid/
        '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

````