API Reference

REST API

Base URL: https://api.agenticwebindex.com

All endpoints accept Authorization: Bearer awi_sk_... header. API keys are managed at /dashboard/api-keys.

GET/v1/lookupFree: 25/day, Pro: unlimited

Search indexed sources by keyword and/or category.

Params: q (string), category (string), limit (int, 1-100), assess_on_miss (bool)

GET/v1/sources/{id}All tiers

Full source detail with intelligence summary, observations, coverage, and recommendations.

Params: id (UUID)

POST/v1/batch/lookupPro only

Batch lookup up to 20 queries in a single request.

Params: queries: [{query, category, limit}]

POST/v1/assessFree: 5/day, Pro: 50/day

Trigger on-demand assessment for a domain not yet in the index.

Params: domain (string), layers (int[])

GET/v1/readiness/{domain}All tiers

Check agent readiness: awi.json, agent-card.json, llms.txt, webmcp.json presence.

Params: domain (string)

GET/v1/assessments/{assessment_run_id}All tiers

Detailed assessment results with fetches, observations, and evidence.

Params: assessment_run_id (UUID)

GET/v1/sources/{id}/historyPro only

Assessment score history over time for trajectory analysis.

Params: id (UUID), category (string), limit (int)

POST/v1/sources/{id}/outcomesAll tiers

Report observed interaction outcome for OBS score computation.

Params: source_id, agent_id, outcome_status, relevance_score, accuracy_score, etc.

Example: Lookup Response

GET /v1/lookup?q=federal+reserve

{
  "count": 1,
  "results": [
    {
      "id": "a1b2c3d4-...",
      "domain": "fred.stlouisfed.org",
      "name": "Federal Reserve Economic Data",
      "provenance_type": "government",
      "posture": "safe",
      "lifecycle_state": "well_understood",
      "interaction_pattern": "fetch_and_read",
      "assessment_score": 0.940,
      "concern_level": "none",
      "access_status": "accessible",
      "acr_score": 0.97,
      "ci_score": 0.91,
      "oa_score": 0.95,
      "prov_score": 0.92,
      "obs_score": 0.88,
      "top_observation": "fred.stlouisfed.org is a content source assessed as nominal for agent interaction.",
      "trajectory": "stable"
    }
  ]
}

Key Response Fields

posturesafe | proceed_with_caution | restrict | avoidPrimary consumer-facing signal. Derived from composite score + concern level.

lifecycle_statenever_seen | partially_known | well_understoodHow well AWI knows this entity. Based on assessment count and recency.

interaction_patternfetch_and_read | call_and_execute | load_and_runHow agents interact with this entity. Determines evaluation strategy.

concern_levelnone | low | moderate | high | criticalObservation-based classification derived from ACR analysis.

access_statusaccessible | partial | blocked | unavailableWhether automated clients can access the content.

top_observationstringIntelligence summary for the entity (paid tier only).