RENTAL DATA · EARLY PREVIEW

Rental source resolution

A canonical value is the platform’s selected value for a fact. It remains reported information, with a traceable source—not independent verification of the property.

Rental facts can come from structured listing website fields or explicit statements in a listing description. An extraction model reads the description; deterministic rules select the canonical facts.

Which source wins

For facts other than lease duration:

Prefer an explicit description fact that passes extraction validation.
If the description does not state the fact, use the structured listing website value.
If neither source supplies a value, keep it unknown.

Lease duration uses the shortest valid term reported by the current listing details or description. For example, six months in listing details and twelve months in the description resolve to six months. Equal durations use the source precedence above.

null means unknown. false and 0 are meaningful values: dogs prohibited and zero bedrooms must not be discarded as missing data. An explicitly described studio has zero bedrooms.

When sources disagree, the applicable rule chooses the value. The original source facts and the winning source are retained internally so the selection can be explained. Validation checks the extracted structure; it does not verify the listing’s claims.

Facts that stay together

Fact group	Resolution rule
Property facts	Property type, bedrooms, and furnishing are selected independently.
Lease offer	The shortest reported term and its associated rent come from one source. Missing rent stays unknown; a different source’s price is not attached to the term.
Pets	Policy, restrictions, and charges stay together for each species. Dogs and cats can have different sources.
Utilities and maintenance	Each service is resolved independently. The details of one utility stay together.
Fees, deposits, concessions, parking	Each complete collection comes from one source. Lists are not combined, which avoids counting the same charge twice. An empty list means nothing was stated; another source may supply the collection.

To compare different duration units, the resolver uses seven days per week, 365 days per year, and one-twelfth of a year per month. This is a comparison convention, not a calculation of contractual dates. Stored values retain their original units. Missing or invalid terms are ignored, and a term removed from a source stops participating when that source refreshes.

Advertised rent remains distinct from rent associated with a specific lease term. All monetary amounts in this rental extraction are USD. No annual lease, monthly conversion, or net effective rent is inferred from missing information.

An example

A listing description advertises $5,146 per month for a 30-day stay. The extracted lease facts are:

lease:
  term:
    value: 30
    unit: day
  term_rent:
    amount: 5146
    period: month

The billing period is monthly, but the advertised stay is 30 days. These facts do not establish the rent for a twelve-month lease.

If the description reports a manufactured or mobile home while a structured field reports a single-family home, the explicit description classification takes precedence. If the description gives no bedroom count, the structured count can still be used.

When a listing changes

New or changed descriptions are processed during eligible listing ingestion. An unchanged description does not trigger another extraction merely because the model version changed.

A successfully processed description replaces its previous claims. If it no longer mentions furnishing, the previous description claim is removed; resolution falls back to the current structured value or unknown. Previous canonical values are never treated as another source.

A missing description field preserves existing facts. An explicitly removed description clears its claims. Source facts and canonical values are saved together; a failed extraction is retried rather than published as an empty successful result.

Interpretation and availability

Description processing is being introduced through a limited geographic pilot. These rules describe resolution where processing is enabled; they do not imply every rental has been processed or that historical listings have been backfilled.

Unknown lease duration does not establish a long-term rental. An empty fee list does not mean there are no fees. The resolved facts describe the advertised offer; eligibility for an estimate or comparable set is a separate decision.