---
title: "Intelligence Verticals API"
description: "8 vertical intelligence endpoints powered by real-time sensor data, knowledge graph, and cross-correlation engine"
canonical: "https://docs.ainative.studio/docs/api/intelligence-verticals"
last-updated: "2026-09-23T01:51:08.820Z"
---

# Intelligence Verticals API

Source: https://docs.ainative.studio/docs/api/intelligence-verticals

> 8 vertical intelligence endpoints powered by real-time sensor data, knowledge graph, and cross-correlation engine

# Intelligence Verticals API

Enterprise data fusion endpoints that cross-correlate lakehouse data across property, environmental, business, infrastructure, developer, M&A, and city intelligence layers.

**Base URL:** `https://api.ainative.studio/api/v1/intelligence`

**Auth:** Bearer JWT token or X-API-Key. Some data is admin-only.

---

## Endpoints

| Endpoint | Description | Key Data Sources |
|----------|-------------|------------------|
| `GET /property` | Property intelligence | SMB businesses, parcels, knowledge graph, sensors |
| `GET /environment` | ESG environmental risk | PurpleAir PM2.5, USGS earthquakes, water quality |
| `GET /infrastructure` | Telecom & network | Submarine cables, BGP, FCC broadband, RIPE probes |
| `GET /business` | Business intelligence | 290K SMB businesses (CRM: admin only) |
| `GET /risk-score` | Composite 0-100 risk | All layers combined |
| `GET /developer` | Developer intelligence | GitHub repos, influence scoring, knowledge graph |
| `GET /acquisition` | M&A intelligence (admin only) | Acquisition targets, signals, grants |

---

## 1. Property Intelligence

Query property data with business, parcel, and sensor overlays.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/property?business_name=acme&lat=36.97&lng=-122.03" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | one of three | Street address to search |
| `business_name` | string | one of three | Business name to search |
| `lat` / `lng` | float | one of three | Latitude/longitude |

**Response:**
```json
{
  "business": { "business_name": "...", "address": "...", "city": "..." },
  "parcels": [{ "apn": "...", "owner_name": "...", "assessed_value": 500000 }],
  "knowledge_graph_entities": [{ "entity_type": "company", "name": "..." }],
  "nearby_sensors": { "aqi_stations_10mi": 5, "earthquakes_30d": 12 },
  "total_matches": 3,
  "source": "lakehouse"
}
```

---

## 2. ESG Environmental Risk

Real-time environmental data from PurpleAir, USGS, AirNow, and Synoptic weather stations.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/environment?lat=36.97&lng=-122.03&radius_mi=25" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `lat` | float | required | Latitude (-90 to 90) |
| `lng` | float | required | Longitude (-180 to 180) |
| `radius_mi` | float | 25 | Search radius in miles |

**Response:**
```json
{
  "aqi": {
    "avg_pm25": 13.0,
    "category": "Moderate",
    "stations_in_range": 5,
    "source": "purpleair"
  },
  "seismic": {
    "events_30d": 2243,
    "max_magnitude": 7.8,
    "avg_magnitude": 3.8,
    "source": "usgs"
  },
  "water_quality": { "monitoring_stations": 556, "source": "usgs_nwis" },
  "weather": { "stations_in_range": 3, "source": "synoptic" },
  "source": "sensor_network",
  "generated_at": "2026-06-24T10:31:59Z"
}
```

---

## 3. Business Intelligence

Cross-correlate SMB businesses and CRM contacts by company, industry, and location.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/business?city=san+francisco&limit=10" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `company_name` | string | — | Company name search |
| `industry` | string | — | Industry/category filter |
| `city` | string | — | City filter |
| `state` | string | — | State (2-letter) |
| `limit` | int | 50 | Max results (1-500) |

**Response:**
```json
{
  "businesses": [{ "business_name": "...", "city": "...", "category": "..." }],
  "contacts": [{ "first_name": "...", "email": "...", "company": "..." }],
  "total_businesses": 40554,
  "total_contacts": 120,
  "source": "lakehouse"
}
```

---

## 4. Infrastructure Intelligence

Telecom, network topology, and broadband data from submarine cables, BGP, FCC, and RIPE Atlas.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/infrastructure?lat=37.77&lng=-122.42&radius_mi=50" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `lat` | float | required | Latitude |
| `lng` | float | required | Longitude |
| `radius_mi` | float | 50 | Search radius in miles |

**Response:**
```json
{
  "submarine_cables": [{ "name": "Pacific Crossing-1", "length_km": 21000 }],
  "bgp_prefixes": [{ "prefix": "1.0.0.0/24", "asn": 13335 }],
  "broadband": [{ "provider_name": "Comcast", "state": "CA" }],
  "network_probes": [{ "probe_id": 12345, "status_name": "Connected" }],
  "total_assets": 57,
  "source": "sensor_network"
}
```

---

## 5. Composite Risk Score

0-100 risk score combining business density, environmental (AQI + seismic), and infrastructure layers. Lower is better.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/risk-score?lat=36.97&lng=-122.03&radius_mi=5" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `lat` | float | required | Latitude |
| `lng` | float | required | Longitude |
| `radius_mi` | float | 5 | Search radius in miles (0.1-50) |

**Response:**
```json
{
  "composite_score": 95.0,
  "components": {
    "business_count": 0,
    "business_density_risk": 30.0,
    "avg_pm25": 71.1,
    "aqi_risk": 20.0,
    "earthquakes_90d": 2243,
    "seismic_risk": 20.0,
    "environmental_risk": 40.0,
    "network_probes": 0,
    "infrastructure_risk": 25.0
  },
  "lat": 36.97,
  "lng": -122.03,
  "source": "computed",
  "generated_at": "2026-06-24T10:32:00Z"
}
```

**Score breakdown:**
- **Business density (0-30):** More businesses = lower risk
- **Environmental (0-40):** AQI risk (0-20) + seismic risk (0-20)
- **Infrastructure (0-30):** More network probes = lower risk

---

## 6. Developer Intelligence

GitHub repos, influence scoring, and knowledge graph connections for developers and orgs.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/developer?github_handle=AINative-Studio" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Required | Description |
|-------|------|----------|-------------|
| `github_handle` | string | one of two | GitHub username or org |
| `company` | string | one of two | Company name |
| `language` | string | — | Filter by primary language |
| `limit` | int | 50 | Max results (1-200) |

**Response:**
```json
{
  "repos": [
    { "name": "agentic-rules", "owner": "AINative-Studio", "stars": 10, "language": "Shell" },
    { "name": "ai-kit", "owner": "AINative-Studio", "stars": 5, "language": "TypeScript" }
  ],
  "influence_score": 12.5,
  "graph_connections": [{ "entity_type": "company", "name": "AINative Studio" }],
  "total_repos": 50,
  "source": "lakehouse"
}
```

---

## 7. M&A / Acquisition Intelligence

Acquisition targets, cross-correlation signals, and grant data for deal intelligence.

```bash
curl "https://api.ainative.studio/api/v1/intelligence/acquisition?city=santa+cruz&min_score=50" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

**Parameters:**

| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `city` | string | — | City filter |
| `state` | string | — | State filter |
| `min_score` | float | 0 | Minimum acquisition score (0-100) |
| `limit` | int | 50 | Max results (1-200) |

**Response:**
```json
{
  "targets": [
    {
      "target_name": "Acme Corp",
      "target_city": "Santa Cruz",
      "target_acquisition_score": 85,
      "target_business_age": 25,
      "parcel_address": "123 Main St"
    }
  ],
  "signals": [{ "signal_type": "foreclosure_match", "source_algo": "acquisition" }],
  "grants": [{ "data_type": "federal_grant" }],
  "total_targets": 50,
  "source": "lakehouse"
}
```

---

## Data Sources

All endpoints are backed by real production data:

| Source | Table | Records | Refresh |
|--------|-------|---------|---------|
| PurpleAir PM2.5 | `sensor_purpleair` | 7,087 | Hourly |
| AirNow EPA | `sensor_airnow` | 1,890 | Hourly |
| USGS Earthquakes | `sensor_earthquakes` | 2,243 | Hourly |
| USGS Water | `sensor_usgs_water` | 2,099 | 6-hourly |
| Synoptic Weather | `sensor_weather_stations` | 999 | Daily |
| Submarine Cables | `sensor_submarine_cables` | 694 | Weekly |
| BGP Prefixes | `sensor_bgp_prefixes` | 10,049 | Daily |
| FCC Broadband | `sensor_fcc_broadband` | 55 | Weekly |
| RIPE Atlas | `sensor_ripe_probes` | 510 | Daily |
| SMB Businesses | `smb_businesses` | 40,554 | Weekly |
| GitHub Repos | `github_repos` | 733 | Daily |
| SCC Intelligence | `scc_intelligence` | 1,449 | Daily |
| Knowledge Graph | `memory_entities` + `entity_edges` | 71K+ | Continuous |

---

## Error Handling

All endpoints return standard error responses:

```json
{
  "detail": "Provide at least one of: address, business_name, or lat+lng",
  "error_code": "VALIDATION_ERROR"
}
```

| Status | Meaning |
|--------|---------|
| 200 | Success |
| 400 | Missing required parameters |
| 401 | Authentication required |
| 500 | Internal server error |

---

## Rate Limits

All intelligence endpoints enforce a 15-second query timeout to protect the database pool. Complex queries across large datasets may be truncated.

Enterprise customers can request higher limits via [support](mailto:support@ainative.studio).

---

*Refs: #4355, #4356, #4357, #4358, #4359*