Skip to main content
The Axiom Locus API exposes 35+ endpoints for location intelligence — composite scoring, POIs, permits, traffic, jobs, predictions, ML exports, monitoring, and PDF report generation.

Base URL

https://axiomlocus.io
(All endpoints are mounted directly under /api/... — there is no version prefix yet.)

Authentication

The free tier GET /api/score and GET /api/pois work without auth. All other endpoints — bulk operations, webhooks, monitoring, PDF generation, ML exports — require a Bearer token:
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://axiomlocus.io/api/bulk-score \
  -H "Content-Type: application/json" \
  -d '{"locations":[{"lat":37.77,"lng":-122.41}]}'
Generate tokens in Settings → API Keys in the Locus dashboard.

Scoring profiles

The composite score and many endpoints accept a profile parameter that adjusts signal weights for the use case:
ProfileOptimized for
generalDefault. Balanced across all signal groups.
qsrQuick-service restaurants — emphasis on foot traffic, demographics, competitor density.
self_storageSelf-storage facilities — emphasis on housing turnover, population density, road accessibility.
retailRetail spaces — emphasis on foot traffic, parking, complementary tenants.
officeOffice leasing — emphasis on transit, daytime population, business vitality.

Confidence

Every score includes a confidence field (0.0–1.0) representing the ratio of data sources that returned data for the location. Coverage varies by metro and by signal — rural areas often have lower confidence than urban ones.

Composite vs sub-scores

Composite scores roll up 8 signal groups:
  1. Business Vitality — net openings, category diversity, rating trajectory
  2. Demographics — population, income, age distribution
  3. Foot Traffic — visit volume, dwell time
  4. Real Estate — pricing trends, transaction velocity
  5. Permits — building activity (new construction, renovation, demolition)
  6. Traffic — vehicle flow, congestion patterns
  7. Jobs — employment density, wage trends
  8. Risk — crime, weather, environmental hazards
Use GET /api/score for the composite. Use the per-signal endpoints (/api/pois, /api/permits, /api/traffic, /api/jobs) for raw data.

Quick start

# 1. Score a single location (no auth)
curl "https://axiomlocus.io/api/score?lat=37.7749&lng=-122.4194"

# 2. Find nearby points of interest
curl "https://axiomlocus.io/api/pois?lat=37.7749&lng=-122.4194&radius=0.5"

# 3. Score 50 locations in a single bulk request (auth required)
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations":[{"lat":37.77,"lng":-122.41},{"lat":34.05,"lng":-118.24}]}' \
  https://axiomlocus.io/api/bulk-score

Where to from here

Core Scoring

/api/score and bulk scoring

Location Data

POIs, permits, traffic, jobs

Predictions

Forward-looking territory forecasts

Reports

Generate branded PDF reports