LogoEurekaNav

Inspectable Infrastructure

AI Representation Control Surfaces

EurekaNav is built to be examined, not just believed. These endpoints expose structured product facts, AI representation scores, and machine-readable data that power our audit, repair, and drift defense workflows.

REST API for data access. A2A protocol for agent interoperability. llms.txt and structured data for AI engine consumption.

Quick Start

1

Explore the API contract

Read the OpenAPI spec — it describes every endpoint, parameter, and response shape.

2

Try an endpoint

curl "https://www.eurekanav.com/api/v1/geo-scores?sort=score_desc&limit=3"
3

Build with it

Use REST for product facts and scores, or A2A JSON-RPC for agent workflows. All responses include meta.apiVersion and meta.schemaVersion for forward compatibility.

Copy-Paste Recipes

Common patterns for accessing product facts and representation data:

Get structured facts for a product

curl -X POST https://www.eurekanav.com/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tool_get_facts","params":{"slug":"linear"}}'

Representation scores across engines

curl "https://www.eurekanav.com/api/v1/geo-scores?sort=score_desc&limit=5"

Recent data changes

curl "https://www.eurekanav.com/api/v1/changes?days=7&limit=10"

Compare products side-by-side

curl -X POST https://www.eurekanav.com/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tool_compare","params":{"slugs":["chatgpt","claude"]}}'

A2A Protocol (Agent-to-Agent)

EurekaNav implements Google's A2A protocol for agent interoperability. Any AI agent that supports A2A can discover EurekaNav's capabilities and query tool data via JSON-RPC.

Agent Card

Live

RFC 8615 discovery endpoint. Declares agent identity, capabilities, and available skills.

GET/.well-known/agent-card.json
curl https://www.eurekanav.com/.well-known/agent-card.json

tool_get_facts

Live

Get structured facts for a single product — canonical pricing, features, use cases, visibility scores, evidence signals, and alternatives.

POST/a2a
curl -X POST https://www.eurekanav.com/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tool_get_facts","params":{"slug":"chatgpt"}}'

tool_search

Live

Search audited products by keyword, category, or AI representation status.

POST/a2a
curl -X POST https://www.eurekanav.com/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tool_search","params":{"q":"writing","limit":5}}'

tool_compare

Live

Compare 2-5 products side-by-side on pricing, features, visibility scores, representation quality, and target audience.

POST/a2a
curl -X POST https://www.eurekanav.com/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tool_compare","params":{"slugs":["chatgpt","claude"]}}'

geo_audit_preview

Coming Soon

AI representation audit for any domain. Returns a gap analysis showing where AI misses, misrepresents, or misattributes your brand.

POST/a2a

REST API

REST endpoints for product facts and representation data. Anonymous access with rate limiting (30 req/min). Pass an API key via X-API-Key header for higher limits (120 req/min). Exceeding limits returns HTTP 429 with a Retry-After header.

List Tools

Live

Paginated list of audited products with structured facts. Filter by category, representation status, or keyword.

GET/api/v1/tools
curl "https://www.eurekanav.com/api/v1/tools?category=AI%20Assistant&limit=10"

Tool Detail

Live

Full structured facts for a single product — pricing, features, FAQ, comparison context, and representation scores.

GET/api/v1/tools/:slug
curl https://www.eurekanav.com/api/v1/tools/chatgpt

GEO Scores

Live

AI visibility scores across 6 engines. Filter by slug, visibility level, or score range.

GET/api/v1/geo-scores
curl "https://www.eurekanav.com/api/v1/geo-scores?visibility=high&sort=score_desc"

Machine-Readable Endpoints

Structured data for AI engines, crawlers, and automated systems.

llms.txt

Live

Machine-readable context file following the llms.txt spec. Helps LLMs understand EurekaNav's content and capabilities.

GET/llms.txt
curl https://www.eurekanav.com/llms.txt

Sitemap

Live

XML sitemap for search engine crawlers.

GET/sitemap.xml

robots.txt

Live

Crawler directives with AI bot-friendly rules.

GET/robots.txt

Authentication

All endpoints support anonymous access with rate limiting. For higher rate limits, include an API key in your requests:

# Via header (recommended)
curl -H "X-API-Key: eak_your_key_here" https://www.eurekanav.com/api/v1/tools

# Via Authorization header
curl -H "Authorization: Bearer eak_your_key_here" https://www.eurekanav.com/api/v1/tools

# Via query parameter
curl "https://www.eurekanav.com/api/v1/tools?api_key=eak_your_key_here"

Rate limits: Anonymous: 30 req/min · Authenticated: 120 req/min

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After (on 429).

Contact support@eurekanav.com for API key access.

Diagnose your AI representation in 5 minutes

One-shot 6-engine audit covering ChatGPT, Perplexity, Gemini, Claude, DeepSeek, and Mistral. See what they say, what they get wrong, and where you're not mentioned. PDF in your inbox, $79 flat, 30-day refund.

Run my audit — $79 See sample report

Further Reading