AreaIQ API

Integrate UK area intelligence into your applications. Generate detailed, data-driven area reports programmatically.

v1REST API • JSON responses • Bearer auth

Authentication

All API requests require a Bearer token. Generate API keys from your dashboard (requires API plan at £79/mo).

Authorization: Bearer aiq_your_api_key_here

Base URL

https://www.area-iq.co.uk/api/v1

Generate Report

POST/api/v1/report

Generate an area intelligence report for a UK location. Reports are powered by 5 real data sources and AI analysis.

Request Body

FieldTypeDescription

areastringUK area name or postcode. E.g. "Shoreditch", "SW1A 1AA", "Manchester"

intentstringOne of: moving, business, investing, research

Example Request

curl -X POST https://www.area-iq.co.uk/api/v1/report \
  -H "Authorization: Bearer aiq_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "area": "Shoreditch",
    "intent": "business"
  }'

Example Response

{
  "id": "rpt_1709834567_a1b2c3",
  "report": {
    "area": "Shoreditch",
    "intent": "business",
    "areaiq_score": 74,
    "sub_scores": [
      {
        "label": "Foot Traffic & Demand",
        "score": 82,
        "weight": 30,
        "summary": "45,000 daily commuters through Liverpool Street..."
      },
      ...
    ],
    "summary": "Shoreditch offers strong commercial potential...",
    "sections": [...],
    "recommendations": [...],
    "data_sources": ["postcodes.io", "police.uk", "IMD 2019", "OpenStreetMap", "Environment Agency"],
    "generated_at": "2026-03-07T12:00:00.000Z"
  }
}

Response Fields

areaiq_scorenumberOverall weighted score (0-100)

sub_scoresarray5 intent-specific dimensions with score, weight, and summary

summarystring2-3 sentence executive summary

sectionsarray4-6 detailed analysis sections with data_points

recommendationsarray3+ actionable recommendations

data_sourcesarrayReal data sources used in this report

Error Codes

401Invalid or missing API key

403API plan required

400Invalid request body (missing area or invalid intent)

500Internal server error

Data Sources

Reports are grounded in real UK government and open data, fetched live for each request:

postcodes.io

Geocoding, ward, LSOA, constituency

police.uk

Street-level crime data, 3-month trends

IMD 2019

Deprivation rank and decile by LSOA

OpenStreetMap

Schools, restaurants, healthcare, transport

Environment Agency

Flood risk areas and active warnings

Rate Limits

API plan includes unlimited report generation. Each report takes 10-20 seconds to generate due to real-time data fetching and AI analysis. Concurrent requests are supported.

SDKs & Integration

The API returns standard JSON over HTTPS. Use any HTTP client:

Node.js / TypeScript

const response = await fetch("https://www.area-iq.co.uk/api/v1/report", {
  method: "POST",
  headers: {
    "Authorization": "Bearer aiq_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    area: "Camden",
    intent: "investing",
  }),
});

const { id, report } = await response.json();
console.log(report.areaiq_score); // 72

Python

import requests

response = requests.post(
    "https://www.area-iq.co.uk/api/v1/report",
    headers={"Authorization": "Bearer aiq_your_api_key"},
    json={"area": "Camden", "intent": "investing"},
)

data = response.json()
print(data["report"]["areaiq_score"])  # 72