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 normalized Realtor.com record. Agent profile rows use record_type: "agent" and group the profile identity, source audit context, contact details, media, brokerage relationships, ratings, listing statistics, and Realtor.com-specific attributes into stable snake_case objects.

When get_reviews is enabled, the dataset also includes linked record_type: "review" rows with entity, review, author, ratings, relationships, and source_context groups. Review rows use review.review_type to distinguish Realtor.com profile reviews from testimonials, and relationships.agent keeps the join context back to the source agent profile. Use max_reviews to cap the combined number of review and testimonial records saved for each profile.

{
  "record_type": "agent",
  "record_id": "example-agent-5deeda36774fb40013d1af17",
  "source_context": {
    "source_name": "Realtor.com",
    "source_domain": "realtor.com",
    "source_url": "https://www.realtor.com/realestateagents/Jane-Parker-9001234",
    "profile_url": "https://www.realtor.com/realestateagents/Jane-Parker-9001234",
    "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"
  },
  "entity": {
    "id": "example-agent-5deeda36774fb40013d1af17",
    "agent_id": "example-agent-5deeda36774fb40013d1af17",
    "fulfillment_id": "9001234",
    "name": "Jane Parker",
    "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.",
    "is_empty_profile": false
  },
  "contact_details": {
    "website": "https://www.example-agent-site.com",
    "phones": [
      { "type": "office", "value": "(323) 555-0142" },
      { "type": "mobile", "value": "(562) 555-0188" }
    ],
    "social_media": {
      "facebook": "https://www.facebook.com/exampleagent",
      "instagram": "https://www.instagram.com/example_agent"
    }
  },
  "media": {
    "avatar": {
      "url": "https://example.com/images/agent-jane-parker.jpg",
      "initials": "JP"
    },
    "about_video": {
      "id": "example-video-id",
      "source": "YOUTUBE",
      "url": "https://youtu.be/example-video-id"
    }
  },
  "relationships": {
    "broker": {
      "name": "Example Realty Partners",
      "fulfillment_id": "9001200"
    },
    "office": {
      "name": "Example Realty Partners"
    },
    "served_areas": [
      { "name": "Los Angeles", "state_code": "CA" },
      { "name": "Long Beach", "state_code": "CA" }
    ],
    "mls": [
      {
        "mls_set": "A-MRCA-M900123",
        "agent_id": "M900123",
        "id": "MRCA",
        "primary": true,
        "license_number": "01900123",
        "status": "A"
      }
    ]
  },
  "metrics": {
    "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": {
        "count": 29,
        "last_sold_date": "2026-05-01",
        "min": 370000,
        "max": 1353000
      }
    },
    "sorting_weight": 70
  },
  "attributes": {
    "is_paid": true,
    "is_realtor": true,
    "display_ratings": true,
    "has_rps": false,
    "designations": ["SFR"],
    "languages": ["Spanish"],
    "intent_type": ["BUYER", "SELLER"],
    "specializations": ["probate sales", "Buyer's agent", "Seller's agent"],
    "experience": {
      "first_year": "2006",
      "first_month": "June",
      "label": "19 years 11 months of experience"
    },
    "services": {
      "buyer": ["Personalized neighborhood guidance"],
      "seller": ["Open houses", "Professional photography"]
    },
    "questions_and_answers": [
      {
        "question": "What makes you stand apart from other agents?",
        "answer": "A client-first approach and deep local transaction experience."
      }
    ],
    "license_number": "01900123",
    "license_state": "CA"
  }
}

Example related review record:

{
  "record_type": "review",
  "record_id": "example-review-1e14fbbef27d8df66866",
  "source_context": {
    "source_name": "Realtor.com",
    "source_domain": "realtor.com",
    "source_url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678",
    "profile_url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678",
    "source": "agent_branding_feedback",
    "operation": "AgentBrandingReviews",
    "detail_url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678"
  },
  "entity": {
    "name": "Alex Morgan review",
    "url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678"
  },
  "review": {
    "review_id": "example-review-2668854b-2389-4da5-9e59-ca61290b6ac8",
    "source_id": "RDC",
    "review_type": "agent_review",
    "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",
    "reply": {
      "message": "Thank you for trusting me with your sale.",
      "reply_date": "2026-05-05"
    }
  },
  "author": {
    "name": "Sample Client",
    "location": "Riverside, CA"
  },
  "ratings": {
    "overall": 5,
    "responsiveness": 5
  },
  "relationships": {
    "agent_id": "example-agent-598510673a857f0011ac6802",
    "fulfillment_id": "9005678",
    "agent_name": "Alex Morgan",
    "agent_url": "https://www.realtor.com/realestateagents/Alex-Morgan-9005678",
    "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",
      "broker": {
        "name": "Example Estate Group",
        "fulfillment_id": "9005600"
      }
    }
  }
}

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.