# Movoto Search API Documentation

<p><strong>Movoto Search API</strong> returns US homes for sale or for rent as JSON, 50 per page. Pass a <code>location</code> such as <code>Austin, TX</code>, <code>78701, TX</code> or a value from the autocomplete route. Filter by price, bedrooms, bathrooms and property type, and page through the results. Every item has the price, address with coordinates, beds, baths, size, lot, year built, HOA fee, property type, status, days on market, photos, the listing agent and office, and the page URL. Item <code>path</code> works in the listing route.</p><p><strong>Filters are never ignored.</strong> Items that break a requested filter are not returned and are counted in <code>pagination.filtered_out</code>. A page is never labelled as another page. A page past the last one returns an empty list. An unknown location returns a 404 error.</p><p><strong>Not offered.</strong> Sorting and living-area filters are not available, because Movoto ignored every form that was tested. Rental items link to the third-party rental page in <code>source_url</code>. Responses carry the MLS notices in <code>notices</code>: show them where you display the listings. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/movoto-api/movoto_search](https://scrappa.co/docs/movoto-api/movoto_search)
- **API group:** Movoto API
- **Endpoint:** `GET https://scrappa.co/api/movoto/search`

## 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 |
| --- | --- | --- | --- |
| `location` | string | Yes | City, county, ZIP or neighborhood: Austin, TX, 78701, TX, or a location value from autocomplete. |
| `listing_type` | string | No | sale (default) or rent. |
| `property_type` | string | No | single_family, condo, multi_family or land. |
| `min_price` | integer | No | Minimum price in USD (rent: per month). |
| `max_price` | integer | No | Maximum price in USD. |
| `min_beds` | integer | No | Minimum bedrooms. |
| `max_beds` | integer | No | Maximum bedrooms, 1 or more. |
| `min_baths` | integer | No | Minimum bathrooms. |
| `max_baths` | integer | No | Maximum bathrooms, 1 or more. |
| `page` | integer | No | One-based page number, 1 to 200 (default 1). |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "8537ada8-054c-4cb2-86c8-e8fcd89aca0f",
                "url": "https://www.movoto.com/austin-tx/1600-barton-springs-rd-apt-1508-austin-tx-78704-404_4828353/",
                "beds": 1,
                "path": "austin-tx/1600-barton-springs-rd-apt-1508-austin-tx-78704-404_4828353/",
                "sqft": 743,
                "baths": 1,
                "price": {
                    "value": 515000,
                    "currency": "USD"
                },
                "mls_id": 404,
                "office": {
                    "name": "Vince Realty",
                    "phone": "(214) 906-9834"
                },
                "photos": [
                    {
                        "url": "https://pi.movoto.com/p/404/5487983_0_Ie237b.webp",
                        "position": 1
                    },
                    {
                        "url": "https://pi.movoto.com/p/404/5487983_0_iR3jVb.webp",
                        "position": 2
                    }
                ],
                "rental": null,
                "status": "Active",
                "address": {
                    "city": "Austin",
                    "full": "1600 Barton Springs Rd #1508 Austin, TX 78704",
                    "unit": "APT 1508",
                    "state": "TX",
                    "county": "Travis County",
                    "street": "1600 Barton Springs Rd #1508",
                    "coordinates": {
                        "latitude": 30.264255,
                        "longitude": -97.760349
                    },
                    "postal_code": "78704",
                    "neighborhood": "Zilker"
                },
                "hoa_fee": 572,
                "lot_sqft": 479,
                "list_date": "2026-10-25",
                "sold_date": null,
                "video_url": null,
                "agent_name": "Rick Orr",
                "mls_number": "5487983",
                "source_url": null,
                "year_built": 2008,
                "has_3d_tour": false,
                "open_houses": [],
                "photo_count": 37,
                "property_id": "9a89d940-9742-4214-906c-6a531eb60fbe",
                "status_code": "ACTIVE",
                "listing_type": "sale",
                "price_change": null,
                "garage_spaces": 1,
                "property_type": {
                    "code": "CONDO",
                    "label": "Condominium"
                },
                "thumbnail_url": "https://pi.movoto.com/p/404/5487983_0_Ie237b_p.webp",
                "days_on_market": 0,
                "virtual_tour_url": "https://sites.listvt.com/mls/268607181",
                "price_changed_date": "2026-10-25"
            }
        ],
        "market": {
            "open_houses": 288,
            "homes_for_sale": 6416,
            "max_listing_price": {
                "value": 20000000,
                "currency": "USD"
            },
            "min_listing_price": {
                "value": 24000,
                "currency": "USD"
            },
            "price_reduced_homes": 1639,
            "average_listing_price": {
                "value": 635471,
                "currency": "USD"
            },
            "median_price_per_sqft": {
                "value": 285,
                "currency": "USD"
            },
            "new_construction_homes": 891
        },
        "notices": [
            {
                "name": "Austin Board of REALTORS\u00ae / Unlock MLS",
                "mls_id": 404,
                "notice": "The data relating to real estate for sale on this web site comes in part from the Austin Board of REALTORS\u00ae (Unlock MLS). Information is provided exclusively fo..."
            }
        ],
        "location": {
            "url": "https://www.movoto.com/austin-tx/",
            "city": "Austin",
            "name": "Austin, TX",
            "type": "CITY",
            "state": "TX",
            "county": "Travis County",
            "coordinates": {
                "latitude": 30.2986219,
                "longitude": -97.7541339
            },
            "postal_code": null
        },
        "pagination": {
            "page": 1,
            "total": 6404,
            "per_page": 50,
            "total_pages": 129,
            "filtered_out": 0,
            "has_next_page": true
        },
        "applied_filters": {
            "location": "austin-tx",
            "listing_type": "sale"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 404 | Not Found | The location was not found. Use the autocomplete route. This response is not billable. |
| 503 | Upstream Unavailable | Movoto 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)
