{"openapi": "3.1.0", "info": {"title": "AXO API", "version": "1.0.0", "description": "Diagnoses whether AI agents can orchestrate bundled service pages in banking, mobility, travel and health (choose, compute, judge cancellation, hand off), with a nine-cell offer card, orchestration readiness and guardrail-checked content blocks. Results build a demand dictionary, an offer ledger and action contracts. Markets: Korea and Japan. Workflow: run_diagnose → get_job → scan_sitemap → run_batch → get_batch → run_site", "contact": {"email": "m-support@listeningmind.com"}}, "servers": [{"url": "https://daas-axo.listeningmind.ai"}], "paths": {"/api/diagnose": {"post": {"operationId": "run_diagnose", "summary": "Check one page", "description": "Diagnoses one service page for agent orchestration across four genres (banking, mobility, travel, health): judges genre and page type with evidence, builds the nine-cell offer card, checks pages against UCP-style fields, scores orchestration readiness over real search scenarios, and drafts guardrail-checked content blocks (also the fact ledger and agent action contract). 100 Lima a run. Returns {job}; read it with get_job (result.axo). Spends ListeningMind Data API credits or paid model calls. Over MCP a person approves it first (you get a confirm link); in the browser the page asks the person. Cost: 100 Lima a run. Time: 1-3 minutes. Usually followed by: get_job.", "tags": ["run"], "x-lm-kind": "run", "x-lm-cost": "100 Lima a run", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"url": {"type": "string", "description": "page address"}, "market": {"type": "string", "enum": ["kr", "jp"], "default": "kr", "description": "market: kr (Korea) or jp (Japan)"}, "kind": {"type": "string", "enum": ["", "product", "compare"], "default": "", "description": "older page type (product or compare); page_type is preferred and overrides it"}, "lang": {"type": "string", "enum": ["ko", "en", "ja"], "default": "ko", "description": "language of the report: ko, en or ja"}, "genre": {"type": "string", "enum": ["", "banking", "mobility", "travel", "health"], "default": "", "description": "service genre: banking (ABO), mobility (AMO), travel (ATO), health (AHO); empty = judged automatically from the page"}, "page_type": {"type": "string", "enum": ["", "detail", "list", "bundle", "rates", "compare", "info", "support", "location", "brand"], "default": "", "description": "page type: detail, list, bundle (package), rates (rate table), compare, info (guide), support (terms), location, brand; empty = judged automatically"}}, "required": ["url"]}}}}}}, "/api/batch": {"post": {"operationId": "start_batch_scan", "summary": "Quick-scan many pages", "description": "Quick scan of up to 300 service pages: genre, page type, offer card, action contract and rule checks from the server HTML (no models) plus one search-volume lookup per page, then ranks them by opportunity = demand share x (100 - quick score). Free. Pick pages for run_batch from get_batch. Spends ListeningMind Data API credits or paid model calls. Over MCP a person approves it first (you get a confirm link); in the browser the page asks the person.", "tags": ["run"], "x-lm-kind": "run", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"urls": {"type": "array", "items": {"type": "string"}, "description": "service page addresses (up to 300)"}, "market": {"type": "string", "enum": ["kr", "jp"], "description": "market"}, "title": {"type": "string", "description": "batch title (usually the site host)"}, "genre": {"type": "string", "description": "banking, mobility, travel or health; empty to detect per page"}}, "required": ["urls"]}}}}}}, "/api/batch/{bid}/run": {"post": {"operationId": "run_batch", "summary": "Check many pages", "description": "Full diagnosis of the pages you pick from a quick-scanned batch (start_batch_scan first). Each page gets the demand dictionary, orchestration readiness, guardrail-checked fixes and the finished page. Charged per page (50 Lima a page, counted from urls); the server runs 2 at a time. Spends ListeningMind Data API credits or paid model calls. Over MCP a person approves it first (you get a confirm link); in the browser the page asks the person. Cost: 50 Lima a page. Usually followed by: get_batch.", "tags": ["run"], "x-lm-kind": "run", "x-lm-cost": "50 Lima a page", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "bid", "in": "path", "required": true, "description": "batch id from start_batch_scan", "schema": {"type": "string"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"urls": {"type": "array", "items": {"type": "string"}, "description": "page addresses from the batch to diagnose fully"}, "ocr": {"type": "boolean", "description": "also read text inside images (slower)"}}, "required": ["urls"]}}}}}}, "/api/site": {"post": {"operationId": "run_site", "summary": "Check a whole site", "description": "Checks how well AI agents can reach a whole financial site (robots, sitemaps, key pages, structured data). 200 Lima a run. Returns {job}; read it with get_job. Spends ListeningMind Data API credits or paid model calls. Over MCP a person approves it first (you get a confirm link); in the browser the page asks the person. Cost: 200 Lima a run. Usually followed by: get_job.", "tags": ["run"], "x-lm-kind": "run", "x-lm-cost": "200 Lima a run", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"url": {"type": "string", "description": "site address"}, "market": {"type": "string", "enum": ["kr", "jp"], "default": "kr", "description": "market: kr (Korea) or jp (Japan)"}, "lang": {"type": "string", "enum": ["ko", "en", "ja"], "default": "ko", "description": "language of the report: ko, en or ja"}}, "required": ["url"]}}}}}}, "/api/sitemap": {"post": {"operationId": "scan_sitemap", "summary": "Read a sitemap", "description": "Reads a sitemap address or pasted addresses and groups the pages, before a batch. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"raw": {"type": "string", "description": "sitemap address or addresses, one a line"}}, "required": ["raw"]}}}}}}, "/api/sitemap/pick": {"post": {"operationId": "pick_sitemap", "summary": "Pick pages for a batch", "description": "Picks pages from a read sitemap by group, kind and count. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"sid": {"type": "string", "description": "sitemap id returned by scan_sitemap"}, "gids": {"type": "array", "items": {"type": "integer"}, "description": "group numbers to take pages from"}, "kinds": {"type": "array", "items": {"type": "string"}, "description": "page kinds to keep (product, compare, ...)"}, "n": {"type": "integer", "description": "how many pages to pick"}, "mode": {"type": "string", "description": "how to pick: spread across groups or take the top ones"}, "q": {"type": "string", "description": "a word the page address must contain"}}, "required": ["sid"]}}}}}}, "/api/job/{jid}": {"get": {"operationId": "get_job", "summary": "Read a check", "description": "One page or site check with its status and result. Its owner (or a public link) only. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "jid", "in": "path", "required": true, "description": "check id (job) returned by run_diagnose or run_site", "schema": {"type": "string"}}]}}, "/api/job/{jid}/snap.jpg": {"get": {"operationId": "get_job_snap", "summary": "Result screenshot", "description": "Screenshot of the diagnosed page with section boxes (JPEG). Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "jid", "in": "path", "required": true, "description": "job id from run_diagnose or run_batch", "schema": {"type": "string"}}]}}, "/p/{jid}": {"get": {"operationId": "get_preview", "summary": "Finished page preview", "description": "Preview of the page with the chosen fixes applied (HTML; s = comma-separated fix ids or all). Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "jid", "in": "path", "required": true, "description": "job id from run_diagnose or run_batch", "schema": {"type": "string"}}]}}, "/p/{jid}/frame": {"get": {"operationId": "get_preview_frame", "summary": "Finished page frame", "description": "The finished page itself, scripts removed (HTML, shown inside the preview). Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "jid", "in": "path", "required": true, "description": "job id from run_diagnose or run_batch", "schema": {"type": "string"}}]}}, "/api/jobs": {"get": {"operationId": "list_jobs", "summary": "My checks", "description": "The signed-in member's page and site checks, newest first. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "limit", "in": "query", "required": false, "description": "how many to list (at most 100)", "schema": {"type": "integer", "default": 30}}]}}, "/api/batch/{bid}": {"get": {"operationId": "get_batch", "summary": "Read a batch", "description": "One batch with every page's status and scores. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "bid", "in": "path", "required": true, "description": "batch id returned by run_batch", "schema": {"type": "string"}}]}}, "/api/batch/{bid}/csv": {"get": {"operationId": "get_batch_csv", "summary": "Batch result CSV", "description": "Downloads a batch board as CSV (one row a page: status, genre, page type, scores). Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "bid", "in": "path", "required": true, "description": "batch id from run_batch", "schema": {"type": "string"}}]}}, "/api/batches": {"get": {"operationId": "list_batches", "summary": "My batches", "description": "The signed-in member's batches. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}}}, "/api/regs": {"get": {"operationId": "get_regs", "summary": "Regulatory guardrails and checks", "description": "Legal guardrail rules AXO applies per genre and market (required notices, prohibited wording, with the law or guideline and its official source), plus the app's own scheduled checks: daily source-change detection, rule self-test and weekly re-check of recently diagnosed pages. Free. Read only, free.", "tags": ["read"], "x-lm-kind": "read", "x-lm-cost": "free", "responses": {"200": {"description": "Success"}, "default": {"description": "Error (application/problem+json or JSON with detail)"}}, "parameters": [{"name": "genre", "in": "query", "required": false, "description": "service genre; empty = all", "schema": {"type": "string", "enum": ["", "banking", "mobility", "travel", "health"], "default": ""}}, {"name": "market", "in": "query", "required": false, "description": "market: kr or jp; empty = both", "schema": {"type": "string", "enum": ["", "kr", "jp"], "default": ""}}]}}}, "externalDocs": {"url": "https://daas-axo.listeningmind.ai/agents.md", "description": "Agent guide"}}