Realtor.com Agents Scraper

Collect enriched real estate agent records from Realtor.com agent search. The actor starts from one or more location inputs, resolves each location through Realtor.com's agent location search, paginates the agent search API for the resolved market, then enriches each saved agent from the Realtor.com branding profile API before writing the dataset.

This initial adaptation keeps the public contract focused on agent search. Price and property-listing filters are not exposed.

Input

Parameter	Type	Description	Default
location	array of strings	Cities or ZIP codes to search, for example Los Angeles, San Francisco, 10001, or Austin, TX. Each value is resolved by Realtor.com before agent collection starts.	Required
deal_type	string	Agent intent filter. Use sell for seller agents, buy for buyer agents, or both to keep Realtor.com's default mixed intent search.	both
agent_name	string	Optional agent name or surname filter. Spaces are sent to Realtor.com in its agent-name query format, such as john smith -> john-smith.	Empty
realtor_com_member	boolean	When enabled, restricts the GraphQL agent search to agents that Realtor.com identifies with a member record.	false
get_reviews	boolean	When enabled, also collects all available reviews and testimonials from each saved agent profile and writes them as separate linked records.	false
max_reviews	integer	Maximum total number of review and testimonial records to save per agent profile when get_reviews is enabled. Leave empty to save all available reviews and testimonials.	Empty
limit	integer	Maximum number of agents to save per location. Leave empty to collect as many matching agents as the run can retrieve.	100 in the UI

Example Input

{
  "location": ["Los Angeles"],
  "deal_type": "both",
  "agent_name": "jane parker",
  "realtor_com_member": true,
  "get_reviews": true,
  "max_reviews": 10,
  "limit": 50
}

Output

Each dataset item is a Realtor.com agent profile record. The saved row starts from the search result, then adds profile-page details such as biography, website, languages, specializations, served areas, MLS and license data, phones, social links, Q&A, and richer office or brokerage data when Realtor.com returns it.

When get_reviews is enabled, the dataset also includes separate agent_review and agent_testimonial records. Each related record includes the agent ID, fulfillment ID, agent name, profile URL, and broker or office context so it can be joined back to the source profile. Use max_reviews to cap the combined number of review and testimonial records saved for each profile.

{
  "id": "example-agent-5deeda36774fb40013d1af17",
  "agent_id": "example-agent-5deeda36774fb40013d1af17",
  "fulfillment_id": "9001234",
  "url": "https://www.realtor.com/realestateagents/Jane-Parker-9001234",
  "name": "Jane Parker",
  "is_paid": true,
  "is_realtor": true,
  "display_ratings": true,
  "has_rps": false,
  "avatar": {
    "url": "https://example.com/images/agent-jane-parker.jpg",
    "initials": "JP"
  },
  "broker": {
    "name": "Example Realty Partners",
    "fulfillment_id": "9001200"
  },
  "office": {
    "name": "Example Realty Partners",
    "website": "https://www.example-realty-partners.com/",
    "phones": [
      {
        "type": "office",
        "value": "(323) 555-0142"
      }
    ],
    "address": {
      "line_1": "123 Market View Ave",
      "line_2": "Suite 400",
      "city": "MONTEBELLO",
      "postal_code": "90640",
      "state_code": "CA"
    }
  },
  "ratings_reviews": {
    "average_rating": 5.0,
    "recommendations_count": 2,
    "reviews_count": 11
  },
  "listing_stats": {
    "combined_annual": {
      "min": 370000,
      "max": 1350000
    },
    "for_sale": {
      "count": 1,
      "last_listing_date": "2026-04-30T23:23:53Z",
      "min": 819000,
      "max": 819000
    },
    "recently_sold_annual": {
      "count": 18
    },
    "recently_sold_listing_details": {
      "listings": [
        {
          "beds": 3.0,
          "baths": 1.0,
          "city": "Compton",
          "state_code": "CA",
          "photo": "https://example.com/images/recent-sale-compton.jpg"
        },
        {
          "beds": 4.0,
          "baths": 3.0,
          "city": "Riverside",
          "state_code": "CA",
          "photo": "https://example.com/images/recent-sale-riverside-1.jpg"
        },
        {
          "beds": 4.0,
          "baths": 2.0,
          "city": "Riverside",
          "state_code": "CA",
          "photo": "https://example.com/images/recent-sale-riverside-2.jpg"
        }
      ],
      "show_additional": true
    },
    "recently_sold": {
      "count": 29,
      "last_sold_date": "2026-05-01",
      "min": 370000,
      "max": 1353000
    }
  },
  "services": {
    "buyer": [
      "Personalized neighborhood guidance",
      "Early access to new listings",
      "Lender referrals",
      "Other professional network referrals"
    ],
    "seller": [
      "Open houses",
      "Professional photography",
      "Home staging",
      "Postcards and flyers",
      "Comparative market analysis"
    ]
  },
  "sorting_weight": 70,
  "source_context": {
    "seed_id": "example-los-angeles-seed",
    "seed_type": "query",
    "seed_value": "Los Angeles",
    "page_index": 1,
    "enriched": true,
    "enrichment_source": "agent_branding_profile",
    "detail_url": "https://www.realtor.com/realestateagents/Jane-Parker-9001234"
  },
  "bio": "Jane Parker is a Los Angeles County real estate professional with more than 20 years of experience helping buyers, sellers, and investors navigate residential transactions. She focuses on clear communication, local market guidance, pricing strategy, and organized transaction support across the greater Los Angeles area.",
  "website": "https://www.example-agent-site.com",
  "designations": ["SFR"],
  "languages": ["Spanish"],
  "intent_type": ["BUYER", "SELLER"],
  "specializations": [
    "Divorce",
    "probate sales",
    "life events sales",
    "foreclosures",
    "short sales",
    "first time buyers",
    "investors",
    "Buyer's agent",
    "Seller's agent"
  ],
  "experience": {
    "first_year": "2006",
    "first_month": "June",
    "label": "19 years 11 months of experience"
  },
  "served_areas": [
    {
      "name": "Corona",
      "state_code": "CA"
    },
    {
      "name": "Downey",
      "state_code": "CA"
    },
    {
      "name": "La Mirada",
      "state_code": "CA"
    },
    {
      "name": "Lakewood",
      "state_code": "CA"
    },
    {
      "name": "Long Beach",
      "state_code": "CA"
    },
    {
      "name": "Los Angeles",
      "state_code": "CA"
    },
    {
      "name": "Montebello",
      "state_code": "CA"
    },
    {
      "name": "Norwalk",
      "state_code": "CA"
    },
    {
      "name": "Ontario",
      "state_code": "CA"
    },
    {
      "name": "Pico Rivera",
      "state_code": "CA"
    },
    {
      "name": "Riverside",
      "state_code": "CA"
    },
    {
      "name": "San Bernardino",
      "state_code": "CA"
    },
    {
      "name": "Santa Fe Springs",
      "state_code": "CA"
    },
    {
      "name": "West Covina",
      "state_code": "CA"
    },
    {
      "name": "Whittier",
      "state_code": "CA"
    }
  ],
  "mls": [
    {
      "mls_set": "A-EXPL-11111111-2222-3333-4444-555555555555",
      "agent_id": "11111111-2222-3333-4444-555555555555",
      "id": "CENT",
      "primary": false,
      "status": "A"
    },
    {
      "mls_set": "A-MRCA-M900123",
      "agent_id": "M900123",
      "id": "MRCA",
      "primary": true,
      "license_number": "01900123",
      "status": "A"
    }
  ],
  "phones": [
    {
      "type": "office",
      "value": "(323) 555-0142"
    },
    {
      "type": "mobile",
      "value": "(562) 555-0188"
    }
  ],
  "license_number": "01900123",
  "license_state": "CA",
  "is_empty_profile": false,
  "social_media": {
    "facebook": "https://www.facebook.com/exampleagent",
    "instagram": "https://www.instagram.com/example_agent",
    "linkedin": "https://www.linkedin.com/in/example-agent",
    "youtube": "https://www.youtube.com/@ExampleAgent"
  },
  "about_video": {
    "id": "example-video-id",
    "source": "YOUTUBE",
    "url": "https://youtu.be/example-video-id"
  },
  "questions_and_answers": [
    {
      "question": "What’s the top reason to hire you?",
      "answer": "With over 20 years of real estate experience and more than 1,000 homes successfully sold, I bring proven results, strategic marketing, and strong negotiation skills to every transaction."
    },
    {
      "question": "What makes you stand apart from other agents?",
      "answer": "What sets me apart is a powerful combination of experience, results, and a client-first approach that consistently delivers success in today’s competitive market."
    },
    {
      "question": "What is the latest market trend in your service area?",
      "answer": "The latest real estate trends in Los Angeles County and surrounding areas show a shifting, more balanced market that is creating new opportunities for both buyers and sellers in 2026."
    },
    {
      "question": "What is your online and offline marketing strategy for sellers?",
      "answer": "My marketing strategy is designed to deliver maximum exposure, strong buyer demand, and top-dollar results by combining cutting-edge online marketing with proven offline techniques."
    }
  ]
}

Example related review record:

{
  "id": "example-review-1e14fbbef27d8df66866",
  "record_type": "agent_review",
  "review_id": "example-review-2668854b-2389-4da5-9e59-ca61290b6ac8",
  "agent_id": "example-agent-598510673a857f0011ac6802",
  "fulfillment_id": "9005678",
  "agent_name": "Alex Morgan",
  "agent_url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678",
  "broker": {
    "name": "Example Estate Group",
    "fulfillment_id": "9005600"
  },
  "source_id": "RDC",
  "reviewer_name": "Sample Client",
  "reviewer_location": "Riverside, CA",
  "rating": 5,
  "comment": "The agent stayed on top of every step and communicated clearly throughout the process.",
  "relationship": "SELLER",
  "started_timestamp": "2026-05-04T16:56:35.962Z",
  "review_date_display": "May 4, 2026",
  "agent": {
    "id": "example-agent-598510673a857f0011ac6802",
    "agent_id": "example-agent-598510673a857f0011ac6802",
    "fulfillment_id": "9005678",
    "name": "Alex Morgan",
    "url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678"
  }
}

Notes

• Location resolution uses Realtor.com's AgentLocationSearch GraphQL operation.
• Agent collection uses Realtor.com's SearchAgents GraphQL operation.
• Each saved record is enriched with Realtor.com's AgentBrandingProfile GraphQL operation before it is written to the dataset.
• Review collection uses Realtor.com's AgentBrandingReviews and AgentBrandingRecommendations GraphQL operations when get_reviews is enabled.
• The actor currently supports city and ZIP-code style resolver results.
• Output fields depend on what Realtor.com returns for each agent at run time.