Skip to main content
GET
/
v1
/
zillow
/
agent
Get Agent Profile
curl --request GET \
  --url https://scrapebadger.com/v1/zillow/agent \
  --header 'x-api-key: <api-key>'
{
  "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

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}).