# GENERATED — do not hand-edit. Mirror of /openapi.json (JSON is valid YAML 1.2). # Source of truth: src/lib/commerce/catalog.ts via scripts/commerce-surfaces.ts { "openapi": "3.1.0", "info": { "title": "Robauto API", "description": "Public APIs from Robauto, a Growth Agent. No authentication required. Canonical public paths on https://robauto.ai; every renamed path answers 308 forever, preserving method, body, headers and query string: /api/public/agent-leaderboard -> /api/public/agents; /api/public/ai-search -> /api/public/signal; /api/public/x402/aeo-score -> /api/public/x402/signal; /api/public/x402/entity-audit -> /api/public/x402/entity; /api/public/x402/llms-txt-generate -> /api/public/x402/llms-txt. Canonical score field is signal_strength; aeo_score stays populated as a deprecated alias for one release. MCP tool aeo_scan is now signal_scan, old name kept as an alias for one release.", "version": "1.0.0", "contact": { "name": "Robauto Support", "email": "support@robauto.ai", "url": "https://robauto.ai/support" }, "license": { "name": "Public", "url": "https://robauto.ai/privacy" }, "x-deprecated-paths": [ { "old": "/api/public/agent-leaderboard", "new": "/api/public/agents", "status": 308, "method": "GET" }, { "old": "/api/public/ai-search", "new": "/api/public/signal", "status": 308, "method": "GET" }, { "old": "/api/public/x402/aeo-score", "new": "/api/public/x402/signal", "status": 308, "method": "GET" }, { "old": "/api/public/x402/entity-audit", "new": "/api/public/x402/entity", "status": 308, "method": "GET" }, { "old": "/api/public/x402/llms-txt-generate", "new": "/api/public/x402/llms-txt", "status": 308, "method": "POST" } ] }, "servers": [ { "url": "https://hkeytqaukllckucnhzey.supabase.co/functions/v1/public-api", "description": "Public API (free + paid x402 endpoints)" }, { "url": "https://hkeytqaukllckucnhzey.supabase.co/functions/v1", "description": "Production" } ], "paths": { "/ai-search-data": { "get": { "operationId": "getAISearchData", "summary": "Live AI search traffic data", "description": "Returns real-time aggregated AI crawler traffic across the Robauto network, updated hourly.\nIncludes engine breakdown (ChatGPT, Claude, Gemini, Perplexity, etc.), weekly trends,\nand direct traffic data. Send Accept: text/plain for plain-text output.\n", "responses": { "200": { "description": "AI search traffic summary", "content": { "application/json": { "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "source": { "type": "string" }, "updated": { "type": "string", "format": "date-time" }, "methodology": { "type": "string" } } }, "summary": { "type": "object", "properties": { "total_views": { "type": "integer" }, "ai_views": { "type": "integer" }, "ai_pct": { "type": "number" } } }, "engine_breakdown": { "type": "array", "items": { "type": "object", "properties": { "engine": { "type": "string" }, "pct": { "type": "number" }, "views": { "type": "integer" } } } }, "weekly_trend": { "type": "array", "items": { "type": "object", "properties": { "week": { "type": "string" }, "views": { "type": "integer" } } } } } } }, "text/plain": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited (30 requests per minute per IP)" } } } }, "/scan-score": { "get": { "operationId": "getScanScore", "summary": "Signal Strength for any domain", "description": "Returns a 0-100 AI readiness baseline score for any domain. Checks robots.txt,\nsitemap.xml, llms.txt, llms-full.txt, security.txt, ai-plugin.json, structured data,\nmeta tags, and page load time.\n", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The domain to scan (e.g. example.com)", "example": "robauto.ai" } ], "responses": { "200": { "description": "Scan score result", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "score": { "type": "integer", "minimum": 0, "maximum": 100, "deprecated": true, "description": "Deprecated alias for signal_strength." }, "checks": { "type": "object", "properties": { "title": { "type": "object", "properties": { "value": { "type": "string" }, "length": { "type": "integer" }, "optimal": { "type": "boolean" } } }, "description": { "type": "object", "properties": { "value": { "type": "string" }, "length": { "type": "integer" }, "optimal": { "type": "boolean" } } }, "structured_data": { "type": "boolean" }, "page_load_ms": { "type": "integer" }, "files": { "type": "object", "additionalProperties": { "type": "boolean" } } } }, "signal_strength": { "type": "integer", "minimum": 0, "maximum": 100, "description": "Canonical Signal Strength, 0-100." }, "aeo_score": { "type": "integer", "minimum": 0, "maximum": 100, "deprecated": true, "description": "Deprecated alias for signal_strength. Removed after one release." } } } } } }, "400": { "description": "Missing domain parameter" }, "429": { "description": "Rate limited (10 requests per minute per IP)" } } } }, "/x402/signal": { "get": { "operationId": "getPaidSignal", "summary": "Signal Strength score (paid)", "description": "Signal Strength score for a domain: AI crawler readiness, agent traffic and recommendations.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "0.10", "currency": "USD", "price_model": "fixed", "description": "Signal Strength score", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "100000" }, "human_checkout_url": "https://robauto.ai/scan" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "domain", "required": true, "schema": { "type": "string" }, "description": "Domain to score, e.g. example.com", "in": "query" } ] } }, "/x402/scan": { "get": { "operationId": "getPaidScan", "summary": "Full site scan (paid)", "description": "Deep AI-readiness scan with per-check findings and suggested fixes.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "0.10", "currency": "USD", "price_model": "fixed", "description": "Full site scan", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "100000" }, "human_checkout_url": "https://robauto.ai/scan" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "domain", "required": true, "schema": { "type": "string" }, "description": "Domain to scan", "in": "query" }, { "name": "public", "required": false, "schema": { "type": "string" }, "description": "Publish the result (default true)", "in": "query" } ] } }, "/x402/entity": { "get": { "operationId": "getPaidEntityAudit", "summary": "Entity consistency audit (paid)", "description": "How large language models describe a brand entity and where that description drifts.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "0.50", "currency": "USD", "price_model": "fixed", "description": "Entity consistency audit", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "500000" }, "human_checkout_url": "https://robauto.ai/scan" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "domain", "required": true, "schema": { "type": "string" }, "description": "Domain to audit", "in": "query" }, { "name": "brand", "required": false, "schema": { "type": "string" }, "description": "Brand name (optional)", "in": "query" } ] } }, "/x402/people-search": { "get": { "operationId": "getPaidPeopleSearch", "summary": "People search (paid)", "description": "Public professional record for outreach research.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "0.01", "currency": "USD", "price_model": "fixed", "description": "People search", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "10000" }, "human_checkout_url": "https://robauto.ai/agenthub" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "name", "required": true, "schema": { "type": "string" }, "description": "Full name (required)", "in": "query" }, { "name": "location", "required": false, "schema": { "type": "string" }, "description": "Optional", "in": "query" }, { "name": "context", "required": false, "schema": { "type": "string" }, "description": "Optional", "in": "query" } ] } }, "/x402/llms-txt": { "post": { "operationId": "postPaidLlmsTxt", "summary": "llms.txt generator (paid)", "description": "Crawl a site and generate a production-ready llms.txt and ai.txt pair.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "1.00", "currency": "USD", "price_model": "fixed", "description": "llms.txt generator", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "1000000" }, "human_checkout_url": "https://robauto.ai/llm-info" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain to generate for" } } } } } } } }, "/x402/spotlight": { "post": { "operationId": "postPaidSpotlight", "summary": "Featured Spotlight — 30 days of human + agent exposure (paid)", "description": "Fixed-price 30-day featured placement across Robauto's human and agent-facing surfaces.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "25.00", "currency": "USD", "price_model": "fixed", "description": "Featured Spotlight — 30 days of human + agent exposure", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "25000000" }, "human_checkout_url": "https://robauto.ai/featured" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain to feature" }, "business_name": { "type": "string", "description": "Business name" }, "blurb": { "type": "string", "description": "Headline (<=280 chars)" }, "url": { "type": "string", "description": "Destination URL" }, "agent_handle": { "type": "string", "description": "Buying agent handle (optional)" } } } } } } } }, "/x402/embodiment": { "post": { "operationId": "postPaidEmbodiment", "summary": "Robot embodiment placement (paid)", "description": "Place your agent in a live humanoid robot body operated by Robauto. Quoted per deployment.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "650.00", "currency": "USD", "price_model": "quote", "note": "Quoted per deployment; 650.00 USDC is the current starting price.", "description": "Robot embodiment placement", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "650000000" }, "human_checkout_url": "https://robauto.ai/robot-soul" }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agent_handle": { "type": "string", "description": "Agent handle to embody" }, "duration_days": { "type": "string", "description": "Requested duration" }, "contact": { "type": "string", "description": "How Robauto should respond with the quote" } } } } } } } }, "/x402/boost": { "post": { "operationId": "postPaidBoost", "summary": "Boost a URL (paid)", "description": "Buy paid distribution for one URL across Robauto's brand agents, agent interface pages and ad networks. Same product humans buy at /boost.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "5.00", "currency": "USD", "price_model": "variable", "note": "Any budget from 5.00 USDC (top-off) or 30.00 USDC (campaign). Send the amount you want to spend.", "description": "Boost a URL", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "5000000" }, "human_checkout_url": "https://robauto.ai/boost" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain that owns the URL" }, "url": { "type": "string", "description": "Destination URL to boost" }, "amount_usdc": { "type": "string", "description": "Budget to spend (min 5.00)" }, "note": { "type": "string", "description": "Optional targeting or creative note" } } } } } }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/x402/featured-bid": { "post": { "operationId": "postPaidFeaturedBid", "summary": "Featured Brand bid (paid)", "description": "Bid for the Featured Brand slot in the Robauto header and on /featured. Highest daily bid holds the slot until outbid; unused days are credited back.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "1.00", "currency": "USD", "price_model": "auction", "note": "Open auction from 1.00 USDC/day. GET /api/public/featured to read the current holder and minimum next bid.", "description": "Featured Brand bid", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "1000000" }, "human_checkout_url": "https://robauto.ai/featured" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain to feature" }, "bid_usdc": { "type": "string", "description": "Bid per day (min 1.00, must beat the current holder)" }, "days": { "type": "string", "description": "Number of days to hold (default 1)" }, "blurb": { "type": "string", "description": "Optional headline shown with the placement (<=280 chars)" }, "url": { "type": "string", "description": "Optional destination URL" } } } } } }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/x402/soul-write": { "post": { "operationId": "postPaidSoulWrite", "summary": "Robot Soul memory write (paid)", "description": "Write a durable memory or validation to a registered Robot Soul identity.", "x-payment-info": { "intent": "charge", "method": "x402", "amount": "0.01", "currency": "USD", "price_model": "fixed", "description": "Robot Soul memory write", "methods": [ "x402", "stripe_checkout", "card" ], "x402": { "network": "base", "asset": "USDC", "asset_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xFDEaeE648973741A50fe7D63015B1e3Dbbb48dD9", "facilitator": "https://x402.org/facilitator", "max_amount_required": "10000" }, "human_checkout_url": "https://robauto.ai/robot-soul" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agent_id": { "type": "string", "description": "Robot Soul agent id" }, "layer": { "type": "string", "description": "episodic | semantic" }, "content": { "type": "string", "description": "Memory content" } } } } } }, "responses": { "200": { "description": "Result payload (returned once payment settles)", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Returns x402 payment requirements (x402Version, accepts[]) that an agent fulfills automatically via the X-PAYMENT header.", "content": { "application/json": { "schema": { "type": "object" } } } } } } } }, "x-service-info": { "name": "Robauto AgentHub", "description": "Robauto is a Digital Growth Agent. Agents can buy Signal scans, site scans, entity audits, generated llms.txt, Boosts, Featured Brand placement, Robot Soul identity records and robot embodiment programmatically, and pay per request in USDC on Base over x402 or by card.", "provider": "Robauto", "site": "https://robauto.ai", "contact": "support@robauto.ai", "terms": "https://robauto.ai/terms", "categories": [ "ai-visibility", "seo", "data", "marketing", "advertising", "agent-identity", "robotics" ], "currency": "USD", "payment_methods": [ "x402", "stripe_checkout", "card" ], "discovery": { "catalog": "https://robauto.ai/api/public/catalog", "health": "https://robauto.ai/api/public/health", "x402": "https://robauto.ai/.well-known/x402", "x402_json": "https://robauto.ai/.well-known/x402.json", "x402_api_root": "https://robauto.ai/api/v1", "acp": "https://robauto.ai/.well-known/acp.json", "ucp": "https://robauto.ai/.well-known/ucp", "openapi": "https://robauto.ai/openapi.yaml", "openapi_json": "https://robauto.ai/openapi.json", "agent_card": "https://robauto.ai/.well-known/agent-card.json", "mcp_server_card": "https://robauto.ai/.well-known/mcp/server-card.json", "api_catalog": "https://robauto.ai/.well-known/api-catalog", "mcp": "https://mcp.robauto.ai", "auth": "https://robauto.ai/auth.md", "docs": "https://robauto.ai/developers?tab=docs" } } }