Developer Documentation

IndexGrid API and integration documentation.

Everything you need to integrate ARIA monitoring data, PIQO schema, and the citation archive into your own systems and dashboards.

→

Quick Start

Your first API call in 5 minutes. Authentication, base URL, first query.

⚡

ARIA API

Read monitoring data, gap alerts, RSOV score, patch queue.

◎

PIQO API

Read and update PIQO documents, trigger schema regeneration.

Quick Start

Authentication

# Install the SDK
npm install @indexgrid/client

# Or use the REST API directly
curl https://api.indexgrid.io/v1/brand/rsov \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

ARIA API Endpoints

GET/v1/brand/rsovCurrent RSOV score + component breakdown

GET/v1/brand/gapsActive gap alerts — type, impact score, risk score

GET/v1/brand/patchesPatch queue — pending, approved, deployed, rejected

GET/v1/brand/citationsCitation archive — all AI engine citations with hashes

GET/v1/brand/monitoring/latestLatest monitoring cycle results

POST/v1/patches/:id/approveApprove a patch (human action required)

Webhooks

Real-time gap and citation events

IndexGrid sends webhooks for: new gap detected, patch approved by human, new AI citation recorded, RSOV score change ±5 points, monitoring cycle complete.

{ "event": "gap.detected", "timestamp": "2026-05-24T08:14:32Z", "brand_id": "brand_abc123", "gap": { "type": "structure_gap", "impact_score": 87, "query": "best D2C brand India", "competitor": "competitor-x.com" } }