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

# Get Agent Profile

> Full detail for a Zillow real-estate professional — profile, reviews, past sales, licenses, and active listings.

## Query Parameters

Provide **either** `username` or `url`.

<ParamField query="username" type="string">
  Zillow profile username (screen name), e.g. `jane-doe`. Taken from a `/profile/<username>/` URL.
</ParamField>

<ParamField query="url" type="string">
  Full Zillow `/profile/...` URL (alternative to `username`).
</ParamField>

## Response

The response wraps a single `Agent` object under an `agent` key.

<ResponseField name="agent" type="object">
  <Expandable title="Agent object">
    <ResponseField name="username" type="string">Profile username (nullable).</ResponseField>
    <ResponseField name="encoded_zuid" type="string">Zillow user id (nullable).</ResponseField>
    <ResponseField name="name" type="string">Full name (nullable).</ResponseField>
    <ResponseField name="url" type="string">Profile URL (nullable).</ResponseField>
    <ResponseField name="profile_photo" type="string">Profile photo URL (nullable).</ResponseField>
    <ResponseField name="phone" type="string">Phone (nullable).</ResponseField>
    <ResponseField name="email" type="string">Email (nullable).</ResponseField>
    <ResponseField name="business_name" type="string">Business / brokerage name (nullable).</ResponseField>
    <ResponseField name="business_address" type="string">Business address (nullable).</ResponseField>
    <ResponseField name="broker_name" type="string">Broker name (nullable).</ResponseField>
    <ResponseField name="title" type="string">Title (nullable).</ResponseField>
    <ResponseField name="bio" type="string">Biography (nullable).</ResponseField>
    <ResponseField name="rating" type="number">Average review rating (nullable).</ResponseField>
    <ResponseField name="review_count" type="integer">Number of reviews (nullable).</ResponseField>
    <ResponseField name="recent_sales_count" type="integer">Recent sales count (nullable).</ResponseField>
    <ResponseField name="total_sales_last_year" type="integer">Total sales in the last year (nullable).</ResponseField>
    <ResponseField name="for_sale_count" type="integer">Active for-sale listings count (nullable).</ResponseField>
    <ResponseField name="for_rent_count" type="integer">Active for-rent listings count (nullable).</ResponseField>
    <ResponseField name="past_sales_count" type="integer">Past sales count (nullable).</ResponseField>
    <ResponseField name="years_experience" type="integer">Years of experience (nullable).</ResponseField>
    <ResponseField name="is_top_agent" type="boolean">Top-agent flag (nullable).</ResponseField>
    <ResponseField name="is_team_lead" type="boolean">Team-lead flag (nullable).</ResponseField>
    <ResponseField name="license_number" type="string">Primary license number (nullable).</ResponseField>
    <ResponseField name="license_state" type="string">Primary license state (nullable).</ResponseField>
    <ResponseField name="website_url" type="string">Personal website URL (nullable).</ResponseField>
    <ResponseField name="facebook_url" type="string">Facebook URL (nullable).</ResponseField>
    <ResponseField name="linkedin_url" type="string">LinkedIn URL (nullable).</ResponseField>
    <ResponseField name="x_url" type="string">X / Twitter URL (nullable).</ResponseField>
    <ResponseField name="video_url" type="string">Intro video URL (nullable).</ResponseField>
    <ResponseField name="specialties" type="array">Specialty tags (list of strings).</ResponseField>
    <ResponseField name="service_areas" type="array">Service area names (list of strings).</ResponseField>
    <ResponseField name="languages" type="array">Languages spoken (list of strings).</ResponseField>

    <ResponseField name="licenses" type="array">
      Professional licenses.

      <Expandable title="License object">
        <ResponseField name="state" type="string">License state (nullable).</ResponseField>
        <ResponseField name="license_type" type="string">License type (nullable).</ResponseField>
        <ResponseField name="license_number" type="string">License number (nullable).</ResponseField>
        <ResponseField name="status" type="string">License status (nullable).</ResponseField>
        <ResponseField name="expiration" type="string">Expiration date (nullable).</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="professional_information" type="array">Raw professional-information label/value records.</ResponseField>

    <ResponseField name="reviews" type="array">
      Agent reviews.

      <Expandable title="Review object">
        <ResponseField name="rating" type="integer">Star rating (nullable).</ResponseField>
        <ResponseField name="comment" type="string">Review text (nullable).</ResponseField>
        <ResponseField name="date" type="string">Raw date label (nullable).</ResponseField>
        <ResponseField name="date_utc" type="number">Date as a Unix timestamp (nullable).</ResponseField>
        <ResponseField name="date_at" type="string">Date as an ISO-8601 string (nullable).</ResponseField>
        <ResponseField name="work_description" type="string">Work described in the review (nullable).</ResponseField>
        <ResponseField name="reviewer_name" type="string">Reviewer name (nullable).</ResponseField>
        <ResponseField name="rebuttal" type="string">Agent's response to the review (nullable).</ResponseField>
        <ResponseField name="sub_ratings" type="array">Category sub-ratings: `{ description, score }`.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="past_sales" type="array">
      Closed transactions.

      <Expandable title="Past sale object">
        <ResponseField name="zpid" type="string">Property id (nullable).</ResponseField>
        <ResponseField name="street_address" type="string">Street line (nullable).</ResponseField>
        <ResponseField name="city_state_zip" type="string">City, state, ZIP (nullable).</ResponseField>
        <ResponseField name="price" type="integer">Sold price (nullable).</ResponseField>
        <ResponseField name="sold_date" type="string">Raw sold date label (nullable).</ResponseField>
        <ResponseField name="sold_date_utc" type="number">Sold date as a Unix timestamp (nullable).</ResponseField>
        <ResponseField name="sold_date_at" type="string">Sold date as an ISO-8601 string (nullable).</ResponseField>
        <ResponseField name="bedrooms" type="number">Bedrooms (nullable).</ResponseField>
        <ResponseField name="bathrooms" type="number">Bathrooms (nullable).</ResponseField>
        <ResponseField name="living_area" type="integer">Interior area (nullable).</ResponseField>
        <ResponseField name="latitude" type="number">Latitude (nullable).</ResponseField>
        <ResponseField name="longitude" type="number">Longitude (nullable).</ResponseField>
        <ResponseField name="represented" type="string">Side represented: `buyer`, `seller`, or `both` (nullable).</ResponseField>
        <ResponseField name="image_url" type="string">Photo URL (nullable).</ResponseField>
        <ResponseField name="url" type="string">Listing URL (nullable).</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="listings" type="array">The agent's active listings — same shape as a search [`Listing`](/api-reference/endpoint/zillow/search) object.</ResponseField>
    <ResponseField name="scraped_utc" type="number">Scrape time as a Unix timestamp (nullable).</ResponseField>
    <ResponseField name="scraped_at" type="string">Scrape time as an ISO-8601 string (nullable).</ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "agent": {
    "username": "jane-doe",
    "encoded_zuid": "X1-ZU10abcd1234_5xyz9",
    "name": "Jane Doe",
    "url": "https://www.zillow.com/profile/jane-doe/",
    "profile_photo": "https://photos.zillowstatic.com/h/p/jane.jpg",
    "phone": "512-555-0100",
    "business_name": "Downtown Realty Group",
    "title": "Real Estate Agent",
    "rating": 4.9,
    "review_count": 128,
    "recent_sales_count": 34,
    "years_experience": 12,
    "is_top_agent": true,
    "license_number": "0654321",
    "license_state": "TX",
    "specialties": ["Buyer's Agent", "Listing Agent"],
    "service_areas": ["Austin, TX", "Round Rock, TX"],
    "languages": ["English", "Spanish"],
    "licenses": [
      { "state": "TX", "license_type": "Real Estate Agent", "license_number": "0654321", "status": "Active" }
    ],
    "reviews": [
      { "rating": 5, "comment": "Fantastic to work with!", "reviewer_name": "buyer123", "work_description": "Helped me buy a home", "sub_ratings": [{ "description": "Responsiveness", "score": 5 }] }
    ],
    "past_sales": [
      { "zpid": "29499726", "street_address": "123 Main St", "city_state_zip": "Austin, TX 78701", "price": 455000, "sold_date_at": "2026-03-15T00:00:00Z", "represented": "seller" }
    ],
    "listings": [
      { "position": 1, "zpid": "30112233", "home_status": "FOR_SALE", "price": 525000, "beds": 4, "baths": 3, "city": "Austin", "state": "TX" }
    ],
    "scraped_at": "2026-07-07T12:00:00Z"
  }
}
```

<Note>
  Each agent-profile request costs **5 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/zillow/agent
openapi: 3.1.0
info:
  title: ScrapeBadger Zillow API
  version: 1.0.0
  description: >-
    Dedicated Zillow scraping API for searching for-sale / for-rent / sold
    listings, fetching maximal property detail (resoFacts home facts,
    price/tax/Zestimate history, schools, agent attribution, mortgage rates,
    photos), agent profiles (reviews, past sales, licenses), region/address
    autocomplete, and coverage reference data.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/zillow/agent:
    get:
      tags:
        - Zillow Agent
      summary: Get Agent Profile
      description: >-
        Get a Zillow real-estate professional's profile, reviews, past sales,
        and active listings. Provide either username or url.
      operationId: getZillowAgent
      parameters:
        - name: username
          in: query
          schema:
            type: string
          description: Zillow profile username (screen name).
        - name: url
          in: query
          schema:
            type: string
          description: Full Zillow /profile/... URL (alternative to username).
      responses:
        '200':
          description: Agent profile
          content:
            application/json:
              schema:
                type: object
                properties:
                  agent:
                    $ref: '#/components/schemas/Agent'
components:
  schemas:
    Agent:
      description: A Zillow real-estate professional profile (from /profile/{username}).
      properties:
        username:
          anyOf:
            - type: string
            - type: 'null'
        encoded_zuid:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        profile_photo:
          anyOf:
            - type: string
            - type: 'null'
        phone:
          anyOf:
            - type: string
            - type: 'null'
        email:
          anyOf:
            - type: string
            - type: 'null'
        business_name:
          anyOf:
            - type: string
            - type: 'null'
        business_address:
          anyOf:
            - type: string
            - type: 'null'
        broker_name:
          anyOf:
            - type: string
            - type: 'null'
        bio:
          anyOf:
            - type: string
            - type: 'null'
        rating:
          anyOf:
            - type: number
            - type: 'null'
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
        recent_sales_count:
          anyOf:
            - type: integer
            - type: 'null'
        total_sales_last_year:
          anyOf:
            - type: integer
            - type: 'null'
        for_sale_count:
          anyOf:
            - type: integer
            - type: 'null'
        for_rent_count:
          anyOf:
            - type: integer
            - type: 'null'
        past_sales_count:
          anyOf:
            - type: integer
            - type: 'null'
        years_experience:
          anyOf:
            - type: integer
            - type: 'null'
        is_top_agent:
          anyOf:
            - type: boolean
            - type: 'null'
        is_team_lead:
          anyOf:
            - type: boolean
            - type: 'null'
        license_number:
          anyOf:
            - type: string
            - type: 'null'
        license_state:
          anyOf:
            - type: string
            - type: 'null'
        website_url:
          anyOf:
            - type: string
            - type: 'null'
        facebook_url:
          anyOf:
            - type: string
            - type: 'null'
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
        x_url:
          anyOf:
            - type: string
            - type: 'null'
        video_url:
          anyOf:
            - type: string
            - type: 'null'
        specialties:
          items:
            type: string
          type: array
        service_areas:
          items:
            type: string
          type: array
        languages:
          items:
            type: string
          type: array
        licenses:
          items:
            $ref: '#/components/schemas/AgentLicense'
          type: array
        professional_information:
          items:
            additionalProperties: true
            type: object
          type: array
        reviews:
          items:
            $ref: '#/components/schemas/AgentReview'
          type: array
        past_sales:
          items:
            $ref: '#/components/schemas/PastSale'
          type: array
        listings:
          items:
            $ref: '#/components/schemas/Listing'
          type: array
        scraped_utc:
          anyOf:
            - type: number
            - type: 'null'
        scraped_at:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    AgentLicense:
      properties:
        state:
          anyOf:
            - type: string
            - type: 'null'
        license_type:
          anyOf:
            - type: string
            - type: 'null'
        license_number:
          anyOf:
            - type: string
            - type: 'null'
        status:
          anyOf:
            - type: string
            - type: 'null'
        expiration:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    AgentReview:
      description: One review on a Zillow agent profile (from `reviewsData.reviews`).
      properties:
        rating:
          anyOf:
            - type: integer
            - type: 'null'
        comment:
          anyOf:
            - type: string
            - type: 'null'
        date:
          anyOf:
            - type: string
            - type: 'null'
        date_utc:
          anyOf:
            - type: number
            - type: 'null'
        date_at:
          anyOf:
            - type: string
            - type: 'null'
        work_description:
          anyOf:
            - type: string
            - type: 'null'
        reviewer_name:
          anyOf:
            - type: string
            - type: 'null'
        rebuttal:
          anyOf:
            - type: string
            - type: 'null'
        sub_ratings:
          items:
            additionalProperties: true
            type: object
          type: array
      type: object
    PastSale:
      description: A closed transaction from an agent's `pastSales` block.
      properties:
        zpid:
          anyOf:
            - type: string
            - type: 'null'
        street_address:
          anyOf:
            - type: string
            - type: 'null'
        city_state_zip:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: integer
            - type: 'null'
        sold_date:
          anyOf:
            - type: string
            - type: 'null'
        sold_date_utc:
          anyOf:
            - type: number
            - type: 'null'
        sold_date_at:
          anyOf:
            - type: string
            - type: 'null'
        bedrooms:
          anyOf:
            - type: number
            - type: 'null'
        bathrooms:
          anyOf:
            - type: number
            - type: 'null'
        living_area:
          anyOf:
            - type: integer
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        represented:
          anyOf:
            - type: string
            - type: 'null'
        image_url:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    Listing:
      description: |-
        One Zillow search card (search / agent listings).

        Merges the search `listResult` top-level with its richer
        `hdpData.homeInfo` sub-object.
      properties:
        position:
          type: integer
        zpid:
          anyOf:
            - type: string
            - type: 'null'
        id:
          anyOf:
            - type: string
            - type: 'null'
        detail_url:
          anyOf:
            - type: string
            - type: 'null'
        home_type:
          anyOf:
            - type: string
            - type: 'null'
        home_status:
          anyOf:
            - type: string
            - type: 'null'
        status_text:
          anyOf:
            - type: string
            - type: 'null'
        status_type:
          anyOf:
            - type: string
            - type: 'null'
        marketing_status:
          anyOf:
            - type: string
            - type: 'null'
        contingent_listing_type:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: integer
            - type: 'null'
        price_raw:
          anyOf:
            - type: string
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        price_change:
          anyOf:
            - type: integer
            - type: 'null'
        date_price_changed_utc:
          anyOf:
            - type: number
            - type: 'null'
        date_price_changed_at:
          anyOf:
            - type: string
            - type: 'null'
        price_reduction:
          anyOf:
            - type: string
            - type: 'null'
        flex_field_text:
          anyOf:
            - type: string
            - type: 'null'
        zestimate:
          anyOf:
            - type: integer
            - type: 'null'
        rent_zestimate:
          anyOf:
            - type: integer
            - type: 'null'
        tax_assessed_value:
          anyOf:
            - type: integer
            - type: 'null'
        beds:
          anyOf:
            - type: number
            - type: 'null'
        baths:
          anyOf:
            - type: number
            - type: 'null'
        living_area:
          anyOf:
            - type: integer
            - type: 'null'
        lot_area_value:
          anyOf:
            - type: number
            - type: 'null'
        lot_area_unit:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        street_address:
          anyOf:
            - type: string
            - type: 'null'
        unit:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        zipcode:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
        is_undisclosed_address:
          anyOf:
            - type: boolean
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        broker_name:
          anyOf:
            - type: string
            - type: 'null'
        provider_listing_id:
          anyOf:
            - type: string
            - type: 'null'
        days_on_zillow:
          anyOf:
            - type: integer
            - type: 'null'
        is_zillow_owned:
          anyOf:
            - type: boolean
            - type: 'null'
        is_featured:
          anyOf:
            - type: boolean
            - type: 'null'
        is_showcase:
          anyOf:
            - type: boolean
            - type: 'null'
        is_fsba:
          anyOf:
            - type: boolean
            - type: 'null'
        is_new_construction:
          anyOf:
            - type: boolean
            - type: 'null'
        is_premier_builder:
          anyOf:
            - type: boolean
            - type: 'null'
        is_preforeclosure_auction:
          anyOf:
            - type: boolean
            - type: 'null'
        is_non_owner_occupied:
          anyOf:
            - type: boolean
            - type: 'null'
        img_src:
          anyOf:
            - type: string
            - type: 'null'
        has_image:
          anyOf:
            - type: boolean
            - type: 'null'
        has_video:
          anyOf:
            - type: boolean
            - type: 'null'
        has_3d_model:
          anyOf:
            - type: boolean
            - type: 'null'
        has_open_house:
          anyOf:
            - type: boolean
            - type: 'null'
        open_house_start:
          anyOf:
            - type: string
            - type: 'null'
        open_house_end:
          anyOf:
            - type: string
            - type: 'null'
        photos:
          items:
            type: string
          type: array
      required:
        - position
      type: object
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````