Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Redfin documentation

Redfin Search API

Search Redfin homes for sale or recently sold homes by region URL, region identifier or map area, with price and property filters.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/redfin/search

// from request to code

Integrate Redfin Search

Build your request and copy it into your stack. Or let your coding agent set it up.

APIRedfin Search
More options 11
Request parameters

Search Redfin homes for sale or recently sold homes by region URL, region identifier or map area, with price and property filters.

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/redfin/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "max_price": 800000,
  "min_beds": 2,
  "region_id": 16163,
  "region_type": 6,
  "limit": 5
}'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/redfin/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "region_id": 16163,
  "region_type": 6,
  "max_price": 800000,
  "min_beds": 2,
  "limit": 5
}

// request reference

Redfin Search parameters

Send query parameters with GET /api/redfin/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

Search Redfin homes for sale or recently sold homes by region URL, region identifier or map area, with price and property filters.

min_price
Min priceOptional

Minimum listing price in US dollars.

Type integer · GET query or POST JSON

  • Minimum: 0
max_price
Max priceOptional

Maximum listing price in US dollars.

Type integer · GET query or POST JSON

  • Minimum: 0
min_beds
Min bedsOptional

Minimum number of bedrooms.

Type integer · GET query or POST JSON

  • Minimum: 0
  • Maximum: 20
max_beds
Max bedsOptional

Maximum number of bedrooms.

Type integer · GET query or POST JSON

  • Minimum: 0
  • Maximum: 20
min_baths
Min bathsOptional

Minimum number of bathrooms.

Type number · GET query or POST JSON

  • Minimum: 0
  • Maximum: 20
min_sqft
Min sqftOptional

Minimum interior area in square feet.

Type integer · GET query or POST JSON

  • Minimum: 0
max_sqft
Max sqftOptional

Maximum interior area in square feet.

Type integer · GET query or POST JSON

  • Minimum: 0
url
UrlOptional

Redfin city, ZIP, county or neighborhood search URL. Existing URL filters are retained unless overridden.

Type string · GET query or POST JSON

  • Supply one location: a region URL, region_id with region_type, or map_bounds.
  • Maximum characters: 2048
region_id
Region idOptional

Redfin region identifier; requires region_type.

Type integer · GET query or POST JSON

  • Greater than: 0
region_type
Region typeOptional

Region kind: 1 neighborhood, 2 ZIP region, 5 county, 6 city, 11 state.

Type integer · GET query or POST JSON

Accepted values125611
  • A ZIP region identifier differs from the ZIP code. Use a Redfin ZIP search URL if the region identifier is unknown.
map_bounds
Map boundsOptional

Map rectangle as north,east,south,west.

Type string · GET query or POST JSON

status
StatusOptional

Listing status. Defaults to for_sale when no URL is supplied.

Type string · GET query or POST JSON

Accepted valuesfor_salesold
sold_within_days
Sold within daysOptional

Sold listings from the last N days; requires status=sold. Defaults to 180 for sold searches.

Type integer · GET query or POST JSON

  • Minimum: 1
  • Maximum: 365
property_type
Property typeOptional

Restrict results to one property type.

Type string · GET query or POST JSON

Accepted valueshousecondotownhousemulti_familylandothermanufacturedco_op
sort
SortOptional

Result ordering. Defaults to recommended when no URL is supplied.

Type string · GET query or POST JSON

Accepted valuesrecommendednewestprice_ascprice_descsqft
limit
LimitOptional

Maximum homes returned. Narrow the region or map bounds when results reach this limit.

Type integer · GET query or POST JSON · Default 100

  • The response does not advertise pagination or a total count. If search_information.possibly_truncated is true, narrow the location or filters.
  • Minimum: 1
  • Maximum: 350

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, properties, search_information, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_metadata": {
    "id": "retained-first-party-fixture",
    "status": "Success",
    "url": "https://api.litescrape.com/api/redfin/search",
    "total_time_taken": 0
  },
  "search_parameters": {
    "region_id": 16163,
    "region_type": 6,
    "limit": 100
  },
  "properties": [
    {
      "property_id": 14602,
      "listing_id": 224286680,
      "address": "1120 8th Ave #1603",
      "city": "Seattle",
      "state": "WA",
      "zipcode": "98101",
      "price": 526500,
      "beds": 2,
      "baths": 2,
      "sqft": 1050,
      "year_built": 1970,
      "status": "Active",
      "property_type": 2,
      "coordinates": {
        "latitude": 47.6092374,
        "longitude": -122.3293587
      },
      "hoa": 825,
      "price_per_sqft": 501,
      "mls_id": "2573739",
      "url": "https://www.redfin.com/WA/Seattle/1120-8th-Ave-98101/unit-1603/home/14602"
    },
    {
      "property_id": 18971,
      "listing_id": 223589242,
      "address": "2201 3rd Ave #1404",
      "city": "Seattle",
      "state": "WA",
      "zipcode": "98121",
      "price": 550000,
      "beds": 2,
      "baths": 2,
      "sqft": 988,
      "year_built": 1979,
      "status": "Active",
      "property_type": 2,
      "coordinates": {
        "latitude": 47.613898,
        "longitude": -122.344043
      },
      "hoa": 1151,
      "price_per_sqft": 557,
      "mls_id": "2583738",
      "url": "https://www.redfin.com/WA/Seattle/2201-3rd-Ave-98121/unit-1404/home/18971"
    },
    {
      "property_id": 307902,
      "listing_id": 224227032,
      "address": "2112 NE 55th St",
      "city": "Seattle",
      "state": "WA",
      "zipcode": "98105",
      "price": 699000,
      "beds": 3,
      "baths": 2,
      "sqft": 1960,
      "lot_sqft": 5000,
      "year_built": 1910,
      "status": "Active",
      "property_type": 1,
      "coordinates": {
        "latitude": 47.6689064,
        "longitude": -122.3048389
      },
      "price_per_sqft": 357,
      "mls_id": "2588282",
      "url": "https://www.redfin.com/WA/Seattle/2112-NE-55th-St-98105/home/307902"
    },
    {
      "property_id": 173648946,
      "listing_id": 224231329,
      "address": "4801 Dayton Ave N Unit C",
      "city": "Seattle",
      "state": "WA",
      "zipcode": "98103",
      "price": 715000,
      "beds": 2,
      "baths": 2.5,
      "sqft": 1300,
      "lot_sqft": 639,
      "year_built": 2021,
      "status": "Active",
      "property_type": 3,
      "coordinates": {
        "latitude": 47.6638027,
        "longitude": -122.3529567
      },
      "hoa": 35,
      "price_per_sqft": 550,
      "mls_id": "2592343",
      "url": "https://www.redfin.com/WA/Seattle/4801-Dayton-Ave-N-98103/unit-C/home/173648946"
    },
    {
      "property_id": 182630821,
      "listing_id": 224228403,
      "address": "820 B S Rose St",
      "city": "Seattle",
      "state": "WA",
      "zipcode": "98108",
      "price": 479950,
      "beds": 2,
      "baths": 1.5,
      "sqft": 830,
      "year_built": 2022,
      "status": "Active",
      "property_type": 1,
      "coordinates": {
        "latitude": 47.529264,
        "longitude": -122.321889
      },
      "hoa": 26,
      "price_per_sqft": 578,
      "mls_id": "2589048",
      "url": "https://www.redfin.com/WA/Seattle/820-B-S-Rose-98108/home/182630821"
    }
  ],
  "search_information": {
    "returned_results": 5,
    "limit": 100,
    "possibly_truncated": false
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Redfin APIs