Intelligence Verticals API

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

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

Auth: Bearer JWT token (all endpoints require authentication)

---

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	40K SMB businesses, CRM contacts
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	Acquisition targets, signals, grants

---

1. Property Intelligence

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

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:

{
  "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.

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:

{
  "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.

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:

{
  "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.

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:

{
  "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.

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:

{
  "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.

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:

{
  "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.

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:

{
  "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:

{
  "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.

---

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