EARLY ACCESS

🔗 ICONYCS Data APIv1.0

Programmatic access to 109M+ U.S. residential properties - demographics, LTV, lender intelligence, and occupancy data at national, state, and local levels.

🏠 109M+ Properties
📍 National to ZIP Level
⚡ 5-Min Cache
🔑 Key Auth
🚀

Early Access - Professional & Enterprise

The ICONYCS Data API is available to Professional and Enterprise subscribers. API keys are issued when ICONYCS launches. Join the waitlist to reserve your key.

Request API Access

🔑 Authentication

All API requests require an API key passed in the X-API-Key request header. Keys are issued to Professional and Enterprise subscribers.

http
GET /api/v1/national HTTP/1.1
Host: iconycs.com
X-API-Key: ick_live_your_api_key_here
[!] Keep your API key confidential. Do not expose it in client-side JavaScript or public repositories.

Base URL

text
https://iconycs.com/api/v1

🔗 Endpoints

MethodPathDescriptionParameters
GET/api/v1/nationalNational housing summary - totals, averages, ethnicity/property/loan breakdowns -
GET/api/v1/state/:stateState-level housing data with full breakdowns
path:state2-letter state code (CA, TX, FL...)
GET/api/v1/demographicsDemographic breakdown - gender, marital, education, income, wealth, ethnicity
querystate2-letter state code
querycityCity name
queryzip5-digit ZIP code
GET/api/v1/ltvLTV tier distribution (FNMA buckets: <=60%, 60-80%, 80-95%, 95-100%, 100%+)
querystate2-letter state code
querycityCity name
queryzip5-digit ZIP code
GET/api/v1/lendersTop lenders by loan volume for any geography
querystate2-letter state code
querycityCity name
querylimitMax results (default: 10, max: 100)
GET/api/v1/occupancyOwner vs. non-owner occupancy split with percentages
querystate2-letter state code
querycityCity name
queryzip5-digit ZIP code

Code Examples

cURL

bash
curl -X GET \
  "https://iconycs.com/api/v1/national" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript (fetch)

javascript
const response = await fetch(
  'https://iconycs.com/api/v1/state/CA',
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
    },
  }
);

const data = await response.json();
console.log(data);
// {
//   version: "1.0",
//   generated: "2025-01-15T18:30:00.000Z",
//   geography: "CA",
//   data: {
//     state: "CA",
//     totalProperties: 14200000,
//     avgPropertyValue: 648000,
//     avgMortgage: 521000,
//     ethnicityBreakdown: [...],
//     propertyBreakdown: [...],
//     loanBreakdown: [...]
//   }
// }

📦 Response Format

All responses return JSON with a consistent envelope. Every response includes:

versionAPI version string
generatedISO 8601 timestamp
geographyGeographic scope of data
dataRequested payload
rowCountResult row count (where applicable)

Example Response - /api/v1/national

json
{
  "version": "1.0",
  "generated": "2025-01-15T18:30:00.000Z",
  "geography": "National",
  "data": {
    "totalProperties": 109811645,
    "avgPropertyValue": 215614,
    "avgMortgage": 185960,
    "ethnicityBreakdown": [
      { "DIMENSION": "ETHNICITY", "LABEL": "White", "COUNT": 72450000 },
      { "DIMENSION": "ETHNICITY", "LABEL": "Hispanic", "COUNT": 15200000 }
    ],
    "propertyBreakdown": [...],
    "loanBreakdown": [...]
  }
}

Response Headers

X-ICONYCS-Version1.0API version
X-RateLimit-Limit100Requests allowed per day
X-RateLimit-Remaining99Requests remaining
Cache-Controls-maxage=3005-minute CDN cache
Access-Control-Allow-Origin*CORS enabled

Rate Limits

PlanDaily LimitNotes
Free - No API access
Professional100 req / dayTest key issued at launch
Enterprise1,000 req / dayPriority support + SLA

Error Codes

401UnauthorizedMissing or invalid X-API-Key header
400Bad RequestInvalid parameters (e.g. state code not 2 letters)
500Internal Server ErrorData query failed - try again or contact support

Ready to get started?

API keys are issued to Professional and Enterprise subscribers at launch. Your key will be waiting for you at iconycs.com/api-docs.

Request API AccessView Pricing