PUBLIC DATA METHODOLOGY
How to interpret AZ Deal Map API data.
AZ Deal Map normalizes bounded Arizona deal-marketing observations, conservatively links them to property records when supported, and exposes only approved fields through lookup-oriented endpoints.
01
Source and product boundaries
The public API serves normalized marketed-offer observations, matched property facts, immutable marketing-event observations, and ZIP-level metric snapshots. It exposes approved projections—not raw source records.
Raw messages and free text, exact source or marketer identity, source URLs, private links, photos, owner/contact data, occupancy, access or lockbox details, earnest-money details, internal notes, source keys, hashes, workbook IDs, message IDs, and record IDs are excluded from public payloads.
Normal API access is bounded by filters, pagination, and date windows. It is not a statewide archive-export interface.
02
Freshness and availability
Freshness is dataset-specific. The service returns 503 DATA_STALE instead of serving live deals after 48 hours without a successful live-deals sync, or properties, events, and markets after 168 hours without their respective successful sync.
Those thresholds are service safety limits, not promises that every field changed within that window. Interpret each row from its observation, source-update, and sync timestamps. A missing value is returned as null; AZ Deal Map does not invent it.
03
Identity and deduplication
Public resource IDs are deterministic, opaque import identifiers. A live deal retains its own deal_id; property_id is present only when the serving record has been safely linked to AZ Deal Map’s durable property identity. A property identity is not a parcel, owner, or title assertion.
Duplicate source keys within an import are rejected rather than silently merged. Marketing events use stable event identities and are stored as immutable observations. Separately, billing deduplication means the same account is not charged again for the same resource, billing class, and representation within 24 hours; it does not remove the resource from the response.
04
Status and history
“Active” means a marketed-offer record satisfied the API’s active serving rule at the latest successful observation. It does not guarantee present availability. A history event means the pipeline observed a property being marketed at a time, sometimes with an asking price, status, and approved coarse source category.
Multiple events can indicate recirculation or a change in observed terms, but they do not by themselves establish distinct contracts, sellers, transactions, acquisitions, dispositions, or closings. Event history is returned newest first for a requested range of no more than 366 days.
05
Public data dictionary
| Field group | Interpretation |
|---|---|
| Public IDs | deal_id, property_id, and event_id are stable opaque API identifiers. Internal source keys, hashes, row IDs, and record IDs are not exposed. |
| Money | Fields such as ask_cents are integer USD cents. For example, 24500000 means $245,000. |
| Times | API timestamps are UTC RFC 3339 strings. observed_at/event_at describe an observation; source_updated_at is the available upstream update time; synced_at is serving-pipeline sync time; response meta.as_of is the response reference time. |
| Location | street_address, city, state, zip, county, latitude, and longitude are returned only on endpoints that project them and may be null when unknown. |
| Property facts | beds, baths, sqft, lot_sqft, year_built, and has_pool are nullable matched-property attributes, not an appraisal or inspection. |
| Marketing fields | status, ask_cents, event_at, and approved coarse source_category values describe observed marketing, not a recorded transaction. |
| Envelope metadata | request_id, as_of, next_cursor, has_more, credits_charged, and credits_remaining describe the API response and account charge. |
06
What AZ Deal Map data does not prove
API data does not prove legal ownership, title condition, parcel identity, lien position, contract control, assignment rights, exclusivity, MLS status, seller identity, current availability, property condition, an executed or closed sale, market value, after-repair value, or investment performance.