{"service":"Cook County (Chicago) property records API","description":"Pay-per-call property-records API for Cook County, Illinois — including the City of Chicago. Look up any property by street ADDRESS or 14-digit PIN and get parcel details, recorded sales & deed history, building permits, and property-tax assessment history, joined and normalized into one answer. Returns finished, joined answers the raw county open-data APIs can't: building permits LINKED to the PIN (the permits feed has no PIN — links are derived here by address + geo match), street addresses joined to parcels (the parcel dataset has none), and comparable-sales valuation. You get the answer, not rows to query, stitch, and derive yourself. Use for real-estate due diligence, automated valuation / comparable-sales (comps), title and lien research prep, lead enrichment, and market analysis. ~1.9M parcels, refreshed nightly, property-keyed (public records only — no personal data). No signup or API key: pay per call via the x402 protocol (USDC on Base or Solana).","coverage":"Cook County, Illinois incl. City of Chicago (~1.9M parcels; recorded sales, building permits, assessments)","keywords":["cook county","chicago","illinois","property records","real estate","parcel","PIN","address lookup","address to PIN","property tax","assessment","recorded sales","deed history","building permits","comparable sales","comps","automated valuation","due diligence","lead enrichment","title research","open data","x402","pay per call"],"auth":"none — pay per call via x402 (no signup, no API key)","payment":{"protocol":"x402","facilitator":"https://facilitator.payai.network","enforced":true,"enabled":true,"asset":"USDC","rails":[{"network":"eip155:8453","pay_to":"0x98D530C0667A4B18e692F182DdCAb1c2bECb5B9B"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","pay_to":"G3qr8ahZnuFSYjvrCYM4LLDdoLzFq8Boq9XrURVcA9YF"}]},"endpoints":{"/v1/search":{"price":"$0.00","description":"Address → PIN lookup for Cook County / Chicago. Resolve a full or partial STREET ADDRESS to its parcel PIN(s): ranked candidate parcels with address, city, ZIP and a match score — resolving the address↔parcel gap (the raw parcel dataset has no address). The entry point when you have an address but not a PIN — call this before /v1/dossier, /v1/parcel, or /v1/comps. Public assessor records. FREE — no payment required (the PIN routes are pay-per-call).","input_schema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Street address or partial (≥4 chars), e.g. '1 E 113th St'"}}},"output_schema":{"type":"object","properties":{"query":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"pin":{"type":"string"},"prop_address":{"type":"string"},"prop_city":{"type":"string"},"prop_zip":{"type":"string"},"score":{"type":"number","description":"0–1 address similarity"}}}}}}},"/v1/parcel":{"price":"$0.01","description":"Single Cook County, IL parcel record by PIN: street address, city, ZIP, assessor property class, township, neighborhood, ward/municipality, census tract, school districts, walkability and airport-noise context, and lat/lon — with the street address joined in (the raw parcel dataset has none). The cheap single-property lookup. Source: Cook County Assessor, refreshed nightly.","input_schema":{"type":"object","required":["pin"],"properties":{"pin":{"type":"string","description":"14-digit Cook County PIN (digits or dashed). Use /v1/search first if you only have a street address."}}},"output_schema":{"type":"object","properties":{"pin":{"type":"string"},"prop_address":{"type":"string"},"prop_city":{"type":"string"},"prop_zip":{"type":"string"},"class":{"type":"string"},"township_name":{"type":"string"},"nbhd_code":{"type":"string"},"tax_year":{"type":"integer"},"lat":{"type":"number"},"lon":{"type":"number"}}}},"/v1/dossier":{"price":"$0.03","description":"Complete property record for a Cook County / Chicago parcel in one paid call: address and parcel basics PLUS recorded sales & deed history, building permits, and property-tax assessment history, joined and normalized — with neighborhood/ward/school/walkability context. Includes building permits LINKED to the PIN — a join the raw permit open-data can't return (it has no PIN; links are derived here by address + geo match). One finished record, not several raw queries to stitch. For real-estate due diligence, valuation, underwriting, and lead enrichment. Nightly-fresh; property-keyed (no personal data).","input_schema":{"type":"object","required":["pin"],"properties":{"pin":{"type":"string","description":"14-digit Cook County PIN (digits or dashed). Use /v1/search first if you only have a street address."}}},"output_schema":{"type":"object","properties":{"pin":{"type":"string"},"prop_address":{"type":"string"},"class":{"type":"string"},"municipality":{"type":"string"},"ward":{"type":"string"},"sales_history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"price":{"type":"number"},"doc_no":{"type":"string"},"deed_type":{"type":"string"}}}},"permits":{"type":"array","items":{"type":"object","properties":{"issued":{"type":"string"},"type":{"type":"string"},"cost":{"type":"number"},"desc":{"type":"string"}}}},"assessment_history":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"certified":{"type":"number"},"board":{"type":"number"}}}}}}},"/v1/comps":{"price":"$0.10","description":"Comparable sales (comps) and a lightweight automated valuation for a Cook County / Chicago property: recent arm's-length sales in the same assessor neighborhood and property class over the last 18 months, with an implied low/median/high price range. Non-arm's-length and multi-parcel deeds are filtered out — a derived valuation you won't get from a raw open-data query. For valuation, underwriting, investment screening, and due diligence.","input_schema":{"type":"object","required":["pin"],"properties":{"pin":{"type":"string","description":"14-digit Cook County PIN (digits or dashed). Use /v1/search first if you only have a street address."}}},"output_schema":{"type":"object","properties":{"pin":{"type":"string"},"comps":{"type":"array","items":{"type":"object","properties":{"pin":{"type":"string"},"prop_address":{"type":"string"},"sale_date":{"type":"string"},"sale_price":{"type":"number"},"deed_type":{"type":"string"}}}},"implied_range":{"type":"object","properties":{"low":{"type":"number"},"median":{"type":"number"},"high":{"type":"number"},"n":{"type":"integer"}}}}}}},"example":{"goal":"property report from a street address","steps":["GET /v1/search/1%20E%20113th%20St  -> candidate PINs","GET /v1/dossier/<pin>  -> full record"]},"free_sample":"/v1/sample","free_examples":["https://api.ingest0r.com/v1/dossier/09253050270000","https://api.ingest0r.com/v1/dossier/09253060510000","https://api.ingest0r.com/v1/dossier/09253140190000"],"pricing_url":"/pricing","changelog":"/changelog.json","version":"0.4.0","as_of":"2026-08-03T03:22:35.820817-05:00","scope":"Cook County, Illinois (incl. City of Chicago) ONLY — not nationwide. Property-keyed public records; no personal, owner, or occupant data.","not_covered":{"geographies":["anywhere outside Cook County, Illinois, USA (no other counties, states, or countries)"],"data":["owner or occupant names","mortgages and liens","nationwide search","interior details or photos","MLS listings or asking prices"]},"freshness":"refreshed nightly from county/city open-data portals","data_policy":"public records only; property-keyed, no personal data"}