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

# Find Agent

> Find Agent



## OpenAPI

````yaml api-reference/zillow/openapi.json get /api/v1/agent/find
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/find:
    get:
      tags:
        - Agent
      summary: Find Agent
      description: Find Agent
      operationId: getApiV1AgentFind
      parameters:
        - in: query
          name: location
          schema:
            type: string
            description: >-
              Find agents by location, such as city, neighborhood, or ZIP code.
              Either `location` or `name` must be provided
            example: New York
        - in: query
          name: name
          schema:
            type: string
            description: Find agents by name. Either `location` or `name` must be provided
            example: Sam
        - in: query
          name: page
          schema:
            type: integer
            exclusiveMinimum: 0
            description: Page number for pagination
            default: 1
            example: 1
        - in: query
          name: is_buying
          schema:
            type: boolean
            description: Filters agents who assist clients with buying properties
            example: true
        - in: query
          name: is_selling
          schema:
            type: boolean
            description: Filters agents who assist clients with selling properties
            example: true
        - in: query
          name: is_top_agent
          schema:
            type: boolean
            description: Filter for top-rated agents
            example: true
        - in: query
          name: price_range
          schema:
            type: string
            description: |-
              price_range filter in format **min,max**

              Example: `50000,1000000` means price from $50,000 to $1,000,000
            example: 50000,1000000
        - in: query
          name: specialty
          schema:
            type: string
            description: |
              Filter by specialties

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


              - `first-time-home-buyers`: First Time Homebuyers
              - `investment-properties`: Investment Properties
              - `rentals`: Rentals
              - `military-or-veterans`: Military/Veterans
              - `luxury-homes`: Luxury Homes
              - `new-construction`: New Construction
              - `property-management`: Property Management
              - `senior-communities`: Senior Communities
              - `relocation`: Relocation
              - `foreclosure`: Foreclosure
              - `lot-or-land`: Lot/Land
              - `vacation-short-term-rentals`: Vacation/Short-term Rentals
            example: first-time-home-buyers,luxury-homes
        - in: query
          name: language
          schema:
            type: string
            description: |
              Filter by languages

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


              - `arabic`: Arabic
              - `bengali`: Bengali
              - `cantonese`: Cantonese
              - `farsi`: Farsi
              - `filipino`: Filipino
              - `french`: French
              - `german`: German
              - `greek`: Greek
              - `hebrew`: Hebrew
              - `hindarian`: Hindarian
              - `italii`: Italian
              - `hungan`: Hungarian
              - `japanese`: Japanese
              - `korean`: Korean
              - `mandar`: Mandarin
              - `portuguese`: Portuguese
              - `russiain`: Russiain
              - `polishn`: Polish
              - `spanish`: Spanish
              - `thai`: Thai
              - `turkish`: Turkish
              - `vietnamese`: Vietnamese
            example: arabic,bengali
      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 agents matching
                    example: 23314
                  has_more:
                    type: boolean
                    description: Whether there are more data to fetch
                    example: true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        encoded_zuid:
                          type: string
                          description: Unique Zillow identifier for the agent
                          example: X1-ZUyy58njdzkphl_aqadk
                        name:
                          type: string
                          description: Name of the agent
                          example: Matt Laricy
                        url:
                          type: string
                          description: Zillow profile URL of the agent
                          example: https://www.zillow.com/profile/Matt-Laricy
                        is_top_agent:
                          type: boolean
                          description: >-
                            Indicates whether the agent is recognized as a
                            top-performing agent
                          example: true
                        image_url:
                          type: string
                          description: URL of the agent’s profile image
                          example: >-
                            https://photos.zillowstatic.com/fp/02c54ad6d005384316302c03eb33d50d-h_l.jpg
                        logo_url:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Logo URL of the agent’s company or team, if
                            available
                          example: null
                        has_team:
                          type: boolean
                          description: Indicates whether the agent is part of a team
                          example: true
                        company:
                          type: string
                          description: >-
                            Name of the brokerage or real estate company the
                            agent is affiliated with
                          example: Americorp Real Estate
                        review_information:
                          type: object
                          properties:
                            review_average:
                              type: number
                              description: Average rating score based on user reviews
                              example: 5
                            review_count:
                              type: number
                              description: Total number of user reviews for the agent
                              example: 1913
                        profile_data:
                          type: array
                          items: {}
                          description: >-
                            Additional performance and activity metrics related
                            to the agent or team
                          example:
                            - data: $44K - $4.3M
                              label: team price range
                            - data: '557'
                              label: team sales last 12 months
                            - data: '5445'
                              label: team sales in Chicago
        '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

````