Platform specifics
Revenue management and concessions
These are the reasons a Apartments.com dataset needs its own handling rather than a shared retail schema.
A rent that changes daily needs daily observation
US multifamily operators widely use revenue-management software that reprices units on a daily cycle against
occupancy, lease expiries and competitor pricing.
- A rent can change several times in a week, with no change to the unit.
- Two identical units in one building carry different rents, because they have different availability
dates.
- The same unit can be cheaper for a 14-month lease than a 12-month one, because the algorithm is smoothing
expiry dates.
So weekly collection misses most of the movement, and a weekly series reads as noise. We recommend daily
minimum here, which is the opposite of our recommendation on
DMart — the right cadence is a property of the pricing behaviour, not a
default.
Unit, not building
unit_id is the record where the listing exposes individual units, with
building_id alongside. A building-level rent averages units that differ by floor, exposure, availability
date and lease term.
Where only a range is published, we record rent_low and rent_high and do not collapse
them to a midpoint — the midpoint of an advertised range is a number nobody quoted.
Concessions are the gap between advertised and effective
US operators compete on concessions rather than on headline rent, because a headline cut resets the rent roll and a
concession does not.
- Free weeks or months — the most common, and spread across the lease term.
- Waived application, admin or amenity fees.
- Gift cards or move-in credits.
- Reduced deposits.
A building advertising $2,400 with six weeks free on a 12-month lease has an effective rent well below $2,400 —
and a competitor at $2,300 with no concession may be more expensive.
What we deliver
concession_text exactly as published, plus structured
concession_type and concession_value where the offer is quantified.
effective_rent is computed only where the concession is fully quantified and the lease term is
stated, with effective_basis naming the calculation.
Where either is missing, effective rent is null with a reason. We do not estimate the value of "ask us about
our specials".
Fees, lease terms, and what we do not collect
Fees outside the rent
Application fees, administration fees, pet rent, pet deposits and parking sit outside the advertised rent and vary
by building. Each is captured as its own field where published.
We do not compute a total cost of occupancy. It depends on pets, parking, utility structure and lease term
— a set of assumptions that belong with you.
Lease term
Rent varies by term, and the relationship is not monotonic. lease_term_months travels with every rent,
and where several terms are quoted for one unit they arrive as separate records rather than a single rent with a
range.
What we do not collect
- Applicant, tenant or leasing-agent personal data, in any form.
- Occupancy or vacancy rates. A unit leaving the listing can mean leased, held or withdrawn.
- Screening criteria or tenant preferences. Where a listing states requirements about prospective tenants, we
do not collect them — the same position as our
SpareRoom page.