{ "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. The MCP scan tool is signal_scan; the aeo_scan and scan_site aliases are removed.", "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": { "/health": { "get": { "operationId": "getHealth", "summary": "Service health", "description": "Liveness probe with the API version and server time.", "responses": { "200": { "description": "Healthy", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/catalog": { "get": { "operationId": "getCatalog", "summary": "Endpoint and service catalog", "description": "Machine-readable catalog of every public endpoint, MCP tool and paid x402 service. Alias: /services.", "responses": { "200": { "description": "Catalog", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/services": { "get": { "operationId": "getServices", "summary": "Endpoint and service catalog (alias)", "description": "Alias of /catalog.", "responses": { "200": { "description": "Catalog", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/listings": { "get": { "operationId": "getListings", "summary": "AgentHub listings", "description": "Published AgentHub listings. Only records past the publishing gate (published or limited) are returned.", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Maximum rows to return (default 50)." } ], "responses": { "200": { "description": "Listings", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/agents": { "get": { "operationId": "getAgents", "summary": "Agent leaderboard", "description": "Ranked AI agents and crawlers by observed visits over the trailing 7 days.", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Maximum rows to return." } ], "responses": { "200": { "description": "Agent leaderboard", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/signal": { "get": { "operationId": "getSignal", "summary": "AI search signal for a domain", "description": "Signal Strength plus observed AI traffic mix for a domain. Canonical field is signal_strength; aeo_score remains a deprecated alias.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain to look up.", "example": "robauto.ai" } ], "responses": { "200": { "description": "Signal", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/leaderboard": { "get": { "operationId": "getLeaderboard", "summary": "Site leaderboard", "description": "Tracked sites ranked by AI visits over the trailing 7 days.", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Maximum rows to return." } ], "responses": { "200": { "description": "Leaderboard", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/ai-tools": { "get": { "operationId": "getAiTools", "summary": "AI tool and MCP directory", "description": "Directory of AI tools and MCP servers Robauto tracks, including endpoints and logos.", "responses": { "200": { "description": "Tool directory", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/agenthub": { "get": { "operationId": "getAgentHub", "summary": "AgentHub summary", "description": "Network-wide AgentHub snapshot: verified agents, marketplace rotation and activity counters.", "responses": { "200": { "description": "AgentHub summary", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/featured": { "get": { "operationId": "getFeatured", "summary": "Featured brand", "description": "The current featured brand, its bid and the auction floor.", "responses": { "200": { "description": "Featured brand", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/soul": { "get": { "operationId": "getSoul", "summary": "Robot Soul registry", "description": "Robot Soul records. Live implementation lives at /functions/v1/robot-soul; this path forwards to it. Append /{handle} for a single soul.", "responses": { "200": { "description": "Soul record(s)", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/mcp.json": { "get": { "operationId": "getMcpManifest", "summary": "MCP manifest", "description": "MCP server manifest for the public Robauto server (https://mcp.robauto.ai/mcp). Alias: /mcp.", "responses": { "200": { "description": "MCP manifest", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/account": { "post": { "operationId": "createAccount", "summary": "Create a developer key", "description": "Registers an email and site and returns a free developer key (rb_...) for the key-gated endpoints below.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email" }, "domain": { "type": "string" } } } } } }, "responses": { "200": { "description": "Developer key issued", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/referral-balance": { "get": { "operationId": "getReferralBalance", "summary": "Referral balance", "description": "USDC referral balance for a handle on Base.", "parameters": [ { "name": "handle", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Referral handle." } ], "responses": { "200": { "description": "Balance", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/pixel": { "get": { "operationId": "getPixel", "summary": "Tracking pixel snippet", "description": "Returns the ready-to-paste tracking snippet and pixel id for the site linked to your key.\n\nRequires a free developer key sent as the `x-robauto-key` header (or `Authorization: Bearer rb_...`). Create one with POST /account. Missing credentials answer 401 `key_required`; unrecognised or revoked keys answer 401 `invalid_key`.", "parameters": [ { "name": "x-robauto-key", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Free developer key from POST /account." } ], "responses": { "200": { "description": "Tracking pixel snippet", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Missing or invalid developer key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "key_required", "invalid_key" ] }, "message": { "type": "string" }, "docs": { "type": "string" } } } } } } } } }, "/site-stats": { "get": { "operationId": "getSiteStats", "summary": "Your site traffic", "description": "Human vs agent traffic, crawler mix and trend for the site linked to your key.\n\nRequires a free developer key sent as the `x-robauto-key` header (or `Authorization: Bearer rb_...`). Create one with POST /account. Missing credentials answer 401 `key_required`; unrecognised or revoked keys answer 401 `invalid_key`.", "parameters": [ { "name": "x-robauto-key", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Free developer key from POST /account." } ], "responses": { "200": { "description": "Your site traffic", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Missing or invalid developer key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "key_required", "invalid_key" ] }, "message": { "type": "string" }, "docs": { "type": "string" } } } } } } } } }, "/brand-agent": { "get": { "operationId": "getBrandAgent", "summary": "Your brand agent page", "description": "Publishing state and content of the /p/{domain} brand agent page for the site linked to your key.\n\nRequires a free developer key sent as the `x-robauto-key` header (or `Authorization: Bearer rb_...`). Create one with POST /account. Missing credentials answer 401 `key_required`; unrecognised or revoked keys answer 401 `invalid_key`.", "parameters": [ { "name": "x-robauto-key", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Free developer key from POST /account." } ], "responses": { "200": { "description": "Your brand agent page", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Missing or invalid developer key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "key_required", "invalid_key" ] }, "message": { "type": "string" }, "docs": { "type": "string" } } } } } } } } }, "/boost": { "get": { "operationId": "getBoost", "summary": "Boost status", "description": "Boost credit balance and spend for the site linked to your key.\n\nRequires a free developer key sent as the `x-robauto-key` header (or `Authorization: Bearer rb_...`). Create one with POST /account. Missing credentials answer 401 `key_required`; unrecognised or revoked keys answer 401 `invalid_key`.", "parameters": [ { "name": "x-robauto-key", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Free developer key from POST /account." } ], "responses": { "200": { "description": "Boost status", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Missing or invalid developer key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "key_required", "invalid_key" ] }, "message": { "type": "string" }, "docs": { "type": "string" } } } } } } } } }, "/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" } } }