Get Agent Profile

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

GET /v1/zillow/agent

Get Agent Profile

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/zillow/agent \
  --header 'x-api-key: <api-key>'

200

{
  "agent": {
    "username": "<string>",
    "encoded_zuid": "<string>",
    "name": "<string>",
    "url": "<string>",
    "profile_photo": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "business_name": "<string>",
    "business_address": "<string>",
    "broker_name": "<string>",
    "bio": "<string>",
    "rating": 123,
    "review_count": 123,
    "recent_sales_count": 123,
    "total_sales_last_year": 123,
    "for_sale_count": 123,
    "for_rent_count": 123,
    "past_sales_count": 123,
    "years_experience": 123,
    "is_top_agent": true,
    "is_team_lead": true,
    "license_number": "<string>",
    "license_state": "<string>",
    "website_url": "<string>",
    "facebook_url": "<string>",
    "linkedin_url": "<string>",
    "x_url": "<string>",
    "video_url": "<string>",
    "specialties": [
      "<string>"
    ],
    "service_areas": [
      "<string>"
    ],
    "languages": [
      "<string>"
    ],
    "licenses": [
      {
        "state": "<string>",
        "license_type": "<string>",
        "license_number": "<string>",
        "status": "<string>",
        "expiration": "<string>"
      }
    ],
    "professional_information": [
      {}
    ],
    "reviews": [
      {
        "rating": 123,
        "comment": "<string>",
        "date": "<string>",
        "date_utc": 123,
        "date_at": "<string>",
        "work_description": "<string>",
        "reviewer_name": "<string>",
        "rebuttal": "<string>",
        "sub_ratings": [
          {}
        ]
      }
    ],
    "past_sales": [
      {
        "zpid": "<string>",
        "street_address": "<string>",
        "city_state_zip": "<string>",
        "price": 123,
        "sold_date": "<string>",
        "sold_date_utc": 123,
        "sold_date_at": "<string>",
        "bedrooms": 123,
        "bathrooms": 123,
        "living_area": 123,
        "latitude": 123,
        "longitude": 123,
        "represented": "<string>",
        "image_url": "<string>",
        "url": "<string>"
      }
    ],
    "listings": [
      {
        "position": 123,
        "zpid": "<string>",
        "id": "<string>",
        "detail_url": "<string>",
        "home_type": "<string>",
        "home_status": "<string>",
        "status_text": "<string>",
        "status_type": "<string>",
        "marketing_status": "<string>",
        "contingent_listing_type": "<string>",
        "price": 123,
        "price_raw": "<string>",
        "currency": "<string>",
        "price_change": 123,
        "date_price_changed_utc": 123,
        "date_price_changed_at": "<string>",
        "price_reduction": "<string>",
        "flex_field_text": "<string>",
        "zestimate": 123,
        "rent_zestimate": 123,
        "tax_assessed_value": 123,
        "beds": 123,
        "baths": 123,
        "living_area": 123,
        "lot_area_value": 123,
        "lot_area_unit": "<string>",
        "address": "<string>",
        "street_address": "<string>",
        "unit": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zipcode": "<string>",
        "country": "<string>",
        "is_undisclosed_address": true,
        "latitude": 123,
        "longitude": 123,
        "broker_name": "<string>",
        "provider_listing_id": "<string>",
        "days_on_zillow": 123,
        "is_zillow_owned": true,
        "is_featured": true,
        "is_showcase": true,
        "is_fsba": true,
        "is_new_construction": true,
        "is_premier_builder": true,
        "is_preforeclosure_auction": true,
        "is_non_owner_occupied": true,
        "img_src": "<string>",
        "has_image": true,
        "has_video": true,
        "has_3d_model": true,
        "has_open_house": true,
        "open_house_start": "<string>",
        "open_house_end": "<string>",
        "photos": [
          "<string>"
        ]
      }
    ],
    "scraped_utc": 123,
    "scraped_at": "<string>"
  }
}

Query Parameters

Provide either username or url.

username · string

Zillow profile username (screen name), e.g. jane-doe. Taken from a /profile/<username>/ URL.

url · string

Full Zillow /profile/... URL (alternative to username).

Response

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

agent · object

Show Agent object

username · string

Profile username (nullable).

encoded_zuid · string

Zillow user id (nullable).

name · string

Full name (nullable).

url · string

Profile URL (nullable).

profile_photo · string

Profile photo URL (nullable).

phone · string

Phone (nullable).

email · string

Email (nullable).

business_name · string

Business / brokerage name (nullable).

business_address · string

Business address (nullable).

broker_name · string

Broker name (nullable).

title · string

Title (nullable).

bio · string

Biography (nullable).

rating · number

Average review rating (nullable).

review_count · integer

Number of reviews (nullable).

recent_sales_count · integer

Recent sales count (nullable).

total_sales_last_year · integer

Total sales in the last year (nullable).

for_sale_count · integer

Active for-sale listings count (nullable).

for_rent_count · integer

Active for-rent listings count (nullable).

past_sales_count · integer

Past sales count (nullable).

years_experience · integer

Years of experience (nullable).

is_top_agent · boolean

Top-agent flag (nullable).

is_team_lead · boolean

Team-lead flag (nullable).

license_number · string

Primary license number (nullable).

license_state · string

Primary license state (nullable).

website_url · string

Personal website URL (nullable).

facebook_url · string

Facebook URL (nullable).

linkedin_url · string

LinkedIn URL (nullable).

x_url · string

X / Twitter URL (nullable).

video_url · string

Intro video URL (nullable).

specialties · array

Specialty tags (list of strings).

service_areas · array

Service area names (list of strings).

languages · array

Languages spoken (list of strings).

licenses · array

Professional licenses.

Show License object

state · string

License state (nullable).

license_type · string

License type (nullable).

license_number · string

License number (nullable).

status · string

License status (nullable).

expiration · string

Expiration date (nullable).

professional_information · array

Raw professional-information label/value records.

reviews · array

Agent reviews.

Show Review object

rating · integer

Star rating (nullable).

comment · string

Review text (nullable).

date · string

Raw date label (nullable).

date_utc · number

Date as a Unix timestamp (nullable).

date_at · string

Date as an ISO-8601 string (nullable).

work_description · string

Work described in the review (nullable).

reviewer_name · string

Reviewer name (nullable).

rebuttal · string

Agent’s response to the review (nullable).

sub_ratings · array

Category sub-ratings: { description, score }.

past_sales · array

Closed transactions.

Show Past sale object

zpid · string

Property id (nullable).

street_address · string

Street line (nullable).

city_state_zip · string

City, state, ZIP (nullable).

price · integer

Sold price (nullable).

sold_date · string

Raw sold date label (nullable).

sold_date_utc · number

Sold date as a Unix timestamp (nullable).

sold_date_at · string

Sold date as an ISO-8601 string (nullable).

bedrooms · number

Bedrooms (nullable).

bathrooms · number

Bathrooms (nullable).

living_area · integer

Interior area (nullable).

latitude · number

Latitude (nullable).

longitude · number

Longitude (nullable).

represented · string

Side represented: buyer, seller, or both (nullable).

image_url · string

Photo URL (nullable).

url · string

Listing URL (nullable).

listings · array

The agent’s active listings — same shape as a search Listing object.

scraped_utc · number

Scrape time as a Unix timestamp (nullable).

scraped_at · string

Scrape time as an ISO-8601 string (nullable).

Example Response

{
  "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"
  }
}

Each agent-profile request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key · string · header · required

Query Parameters

username · string

Zillow profile username (screen name).

url · string

Full Zillow /profile/... URL (alternative to username).

Response

200 - application/json

Agent profile

agent · object

A Zillow real-estate professional profile (from /profile/{username}).

Show child attributes