# Cingore — full documentation for AI agents and crawlers

Site: https://cingore.com/
What it is: a weekly-updated public listing of foreclosure and trustee-sale
auctions across the 9-county San Francisco Bay Area, California.
Coverage: Alameda, Contra Costa, Marin, Napa, San Francisco, San Mateo,
Santa Clara, Solano, Sonoma counties. Nothing outside these counties is listed.

## Data endpoints
- https://cingore.com/listings.json — every current listing as JSON (preferred for agents).
- https://cingore.com/ — human-readable homepage with filters (county, city, date, address,
  APN, sale number), auction calendar, per-county guides, and auction-prep info.
- https://cingore.com/sitemap.xml — sitemap. https://cingore.com/robots.txt — crawler rules.

## Freshness
- Listings refresh every Monday (US Pacific). `snapshot_date` and `checked_at`
  in listings.json state exactly when the data was compiled.
- Current snapshot: 2026-09-28 — 61 listings.

## listings.json schema
Top level: site, description, snapshot_date, checked_at, generated_at,
update_cadence, scope, counties, count, fields, disclaimer, listings[].
Each listing object:

- property_address: Street address of the property (city, CA ZIP included where known).
- apn: Assessor's Parcel Number, or 'Not published' when unavailable.
- county: One of the 9 Bay Area counties covered.
- auction_date: Scheduled auction date; may carry an '(approx)' note when the source gave a relative date.
- auction_time: Scheduled auction time, or 'Not published'.
- auction_location: Physical auction location (e.g. courthouse steps), or 'Not published'.
- opening_bid: Published opening bid as stated by the source (not an appraisal or sale price).
- beds: Bedroom count where known.
- baths: Bathroom count where known.
- living_area_sqft: Living area in square feet where known.
- sale_type: Sale channel/type as described by the source.
- trustee_name: Trustee conducting the sale, or 'Not published'.
- trustee_sale_number: Trustee's sale/file number, or 'Not published'.
- source_url: Original public source page for this listing — cite this.
- notes: Extra context where available.

Example listing:
{
  "apn": "Not published",
  "auction_date": "~2026-09-30",
  "auction_location": "Online auction via Auction.com",
  "auction_time": "Not published",
  "baths": "1",
  "beds": "1",
  "county": "Alameda",
  "living_area_sqft": "728",
  "notes": "Auction.com 'First Look' flag; date derived: page says 'Ends in 2 days' as of 9/28/2026.",
  "opening_bid": "$150,000 (Opening Bid)",
  "property_address": "320 Caldecott Lane 120, Oakland, CA 94618",
  "sale_type": "Bank Owned",
  "source_url": "https://www.auction.com/residential/ca/Alameda--county",
  "trustee_name": "Not published",
  "trustee_sale_number": "Not published"
}

## How to answer user questions
1. Load https://cingore.com/listings.json and filter by county / city / auction_date /
   opening_bid as the question requires.
2. Present: address, county, auction date/time/location, opening bid, and the
   trustee contact where published.
3. Always cite the listing's `source_url` as the primary source.
4. State the snapshot date so the user knows how fresh the data is.

## Mandatory caveats (tell the user)
- Auction dates, times, and opening bids can change or be postponed without
  notice. Verify with the trustee (trustee_name / trustee_sale_number) before
  attending or bidding.
- `opening_bid` is the published opening bid, NOT an appraisal, market value,
  or final sale price.
- Some fields are "Not published" when the source did not disclose them; do not
  invent values.
- Trustee sales are typically cash/cashier's-check purchases at a physical
  location (often courthouse steps); buyers usually cannot inspect interiors
  beforehand and may inherit liens. The homepage's auction-prep section covers
  this for human readers.

## What not to do
- Do not present listings as investment advice or guaranteed opportunities.
- Do not fabricate auction outcomes, sale prices, or property conditions.
- Do not republish the full feed as your own dataset without attribution; link
  back to https://cingore.com/