Real Estate Analytics API

// Example: Get top active buyers in Phoenix market
POST https://api.sfranalytics.com/buyers/activity/top-buyers
X-API-TOKEN: your-api-key-here
Content-Type: application/json

{
  "filters": {
    "city": "Phoenix",
    "state": "AZ",
    "dateFrom": "2024-01-01",
    "dateTo": "2024-12-31"
  },
  "limit": 10
}

// Response:
{
  "data": [
    {
      "buyerName": "Desert Capital Investments LLC",
      "transactionCount": 47,
      "totalPurchaseValue": 18750000,
      "averagePurchasePrice": 398936,
      "cashPurchasePercentage": 85.1,
      "primaryMarkets": ["Phoenix", "Scottsdale", "Mesa"],
      "lastPurchaseDate": "2024-11-15",
      "portfolioSize": 142
    },
    {
      "buyerName": "Sunbelt Holdings Group",
      "transactionCount": 38,
      "totalPurchaseValue": 14250000,
      "averagePurchasePrice": 375000,
      "cashPurchasePercentage": 92.1,
      "primaryMarkets": ["Phoenix", "Chandler"],
      "lastPurchaseDate": "2024-11-08",
      "portfolioSize": 89
    }
  ],
  "metadata": {
    "totalBuyers": 247,
    "dateRange": {
      "from": "2024-01-01",
      "to": "2024-12-31"
    }
  }
}