# Homes.com Agent API Documentation

Homes.com Agent API returns one real estate agent: name, agency, office address, phone numbers the site shows, bio, years of experience, designations, languages, sales statistics, areas served, reviews, active listings, open houses and recent sales. Email addresses are never returned. Get the id from agent.agent_id in search and listing results or from the agent autocomplete route. An unknown agent returns 404 and is not billed.

- **Documentation:** [https://scrappa.co/docs/homes-com-api/homes_com_agent](https://scrappa.co/docs/homes-com-api/homes_com_agent) - **API group:** Homes.com API - **Endpoint:** `GET https://scrappa.co/api/homes-com/agent` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | Agent id. Example: y9800qv. | ## Example response ```json { "data": { "bio": "22 years in real estate", "url": "https://www.homes.com/real-estate-agents/hiran-marin/y9800qv/", "name": "Hiran Marin", "phone": "(877) 846-1277", "sales": { "max_price": 1090000, "min_price": 281000, "buyer_deals": 3, "total_value": { "label": "$3.1M", "value": 3103939, "currency": "USD" }, "closed_sales": 6, "seller_deals": 3, "average_price": { "label": "$517.3K", "value": 517323.1666666667, "currency": "USD" }, "price_range_label": "$281K - $1.1M" }, "agency": "Lewis Real Estate Group", "address": { "city": "Austin", "state": "TX", "street": "1019 Reinli St.", "postal_code": "78723" }, "reviews": { "homes": [], "google": [] }, "agent_id": "y9800qv", "languages": [ "Spanish" ], "last_name": "Marin", "photo_url": null, "first_name": "Hiran", "home_types": [ "House" ], "is_verified": false, "open_houses": [], "areas_served": [ { "name": "Highland", "deal_count": 1, "description": "1 Sale" }, { "name": "Stony Point", "deal_count": 1, "description": "1 Sale" } ], "designations": [ "NAR - National Association of Realtors" ], "office_phone": "(512) 454-8600", "recent_sales": [ { "id": "gc95tmcstsspt", "url": "https://www.homes.com/property/6413-jennings-dr-austin-tx/gc95tmcstsspt/", "beds": 3, "sqft": 1297, "baths": 2, "price": { "label": "$300,000", "value": 300000, "currency": "USD" }, "address": "6413 Jennings Dr", "caption": "For Sale $300,000", "photo_url": "https://images.homes.com/listings/111/8452416515-295566732/6413-jennings-dr-austin-tx-primaryphoto.jpg" }, { "id": "9sqzksqplk10m", "url": "https://www.homes.com/property/1601-alazan-cove-round-rock-tx/9sqzksqplk10m/#sold=5n2r6sb82rd0p", "beds": 3, "sqft": 1492, "baths": 2, "price": null, "address": "1601 Alazan Cove", "caption": "Sold", "photo_url": "https://images.homes.com/listings/111/5252757403-634755941/1601-alazan-cove-round-rock-tx-primaryphoto.jpg" } ], "review_count": 0, "active_listings": [ { "id": "gc95tmcstsspt", "url": "https://www.homes.com/property/6413-jennings-dr-austin-tx/gc95tmcstsspt/", "beds": 3, "sqft": 1297, "agent": { "name": "Hiran Marin", "phone": "(512) 413-4663", "agency": "Monumental Realty", "agent_id": "y9800qv", "photo_url": null, "agency_logo_url": null }, "baths": 2, "price": { "label": "$300,000", "value": 300000, "currency": "USD" }, "badges": [], "photos": [ { "url": "https://images.homes.com/listings/111/8452416515-295566732/6413-jennings-dr-austin-tx-primaryphoto.jpg", "width": 1024, "height": 768, "caption": null }, { "url": "https://images.homes.com/listings/116/5552416515-295566732/6413-jennings-dr-austin-tx-buildingphoto-2.jpg?t=p", "width": 768, "height": 1024, "caption": null } ], "status": "active", "address": { "city": "Austin", "full": "6413 Jennings Dr, Austin, TX 78727", "unit": null, "state": "TX", "street": "6413 Jennings Dr", "building": null, "coordinates": { "latitude": 30.439204, "longitude": -97.752399 }, "postal_code": "78727" }, "builder": null, "beds_max": 3, "beds_min": 3, "lot_sqft": null, "rent_max": null, "rent_min": null, "sqft_max": 1297, "sqft_min": 1297, "baths_max": 2, "baths_min": 2, "community": null, "list_date": "2026-10-09T00:00:00+00:00", "lot_acres": null, "photo_url": "https://images.homes.com/listings/111/8452416515-295566732/6413-jennings-dr-austin-tx-primaryphoto.jpg", "sold_date": null, "beds_label": "3 Beds", "highlights": [], "listing_id": "e9yrn03ft4mwl", "year_built": 1984, "baths_label": "2 Baths", "description": "A great home in a wonderful area.", "open_houses": [], "units_count": null, "listing_type": "sale", "property_type": { "code": 1, "slug": "house", "label": "House" }, "days_on_market": null, "original_price": { "label": null, "value": 300000, "currency": "USD" }, "price_per_sqft": 231, "property_manager": null, "available_units_count": null }, { "id": "qg1pj5defg4vh", "url": "https://www.homes.com/property/0-lunar-dr-burnet-tx-unit-act5081963/qg1pj5defg4vh/", "beds": null, "sqft": null, "agent": { "name": "Hiran Marin", "phone": "(512) 413-4663", "agency": "Monumental Realty", "agent_id": "y9800qv", "photo_url": null, "agency_logo_url": null }, "baths": 0, "price": { "label": "$15,000", "value": 15000, "currency": "USD" }, "badges": [ "$3K PRICE INCREASE" ], "photos": [ { "url": "https://images.homes.com/listings/111/5702238793-066540681/0-lunar-dr-burnet-tx-primaryphoto.jpg", "width": 240, "height": 180, "caption": null }, { "url": "https://images.homes.com/listings/111/5802238793-066540681/0-lunar-dr-burnet-tx-buildingphoto-2.jpg", "width": 240, "height": 180, "caption": null } ], "status": "active", "address": { "city": "Burnet", "full": "0 Lunar Dr Unit ACT5081963, Burnet, TX 78611", "unit": "Unit ACT5081963", "state": "TX", "street": "0 Lunar Dr", "building": null, "coordinates": { "latitude": 30.861078, "longitude": -98.395435 }, "postal_code": "78611" }, "builder": null, "beds_max": null, "beds_min": null, "lot_sqft": 5401, "rent_max": null, "rent_min": null, "sqft_max": null, "sqft_min": null, "baths_max": 0, "baths_min": 0, "community": null, "list_date": "2024-10-04T00:00:00+00:00", "lot_acres": 0.12, "photo_url": "https://images.homes.com/listings/111/5702238793-066540681/0-lunar-dr-burnet-tx-primaryphoto.jpg", "sold_date": null, "beds_label": null, "highlights": [], "listing_id": "6fe4ec54rd4w6", "year_built": null, "baths_label": null, "description": "Great lot to build on.", "open_houses": [], "units_count": null, "listing_type": "sale", "property_type": { "code": 32, "slug": null, "label": "Land" }, "days_on_market": null, "original_price": { "label": null, "value": 12000, "currency": "USD" }, "price_per_sqft": null, "property_manager": null, "available_units_count": null } ], "locations_served": [], "years_experience": 24 }, "meta": { "billable": true, "endpoint_family": "agent" }, "success": true } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A required parameter or a range is invalid, or the page is beyond the first 700 results. This response is not billable. | | 404 | Not Found | The agent does not exist. This response is not billable. | | 503 | Upstream Unavailable | Homes.com could not be reached or returned data that does not match the request. This response is not billable and is retryable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)