{"openapi":"3.1.0","info":{"title":"Argosor — Unified SEO, SERP, Clean Markdown & GEO (LLM Citation Visibility) API","version":"1.0.0","description":"Production REST API v1 and Streamable HTTP MCP Server (/mcp) for AI agents and growth engineering teams. Dual execution mode: Managed Global Edge (70% cheaper than DataForSEO, SerpApi, Ahrefs, Semrush & Firecrawl) or BYOK ($0 markup via AES-256-GCM Encrypted Vault).","contact":{"name":"Allometrik Consulting FZCO","email":"jose@allometrik.com","url":"https://argosor.com"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"servers":[{"url":"https://api.argosor.com","description":"Argosor production API"},{"url":"https://argosor.com","description":"Argosor canonical domain"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"arg_live_...","description":"Argosor Workspace API Key (arg_live_...) or session token (scr_sess_...)."}}},"security":[{"BearerAuth":[]}],"paths":{"/health":{"get":{"operationId":"getHealth","summary":"Global Edge Runtime Health & Storage Status","responses":{"200":{"description":"Healthy status response"}}}},"/mcp":{"post":{"operationId":"handleMcpRpc","summary":"MCP 2025-03-26 Streamable HTTP JSON-RPC Endpoint (15 Semantic Tools)","responses":{"200":{"description":"JSON-RPC 2.0 response"}}}},"/v1/serp/search":{"post":{"operationId":"serpLiveSearch","summary":"Execute a real-time SERP & AI Overview search across Google, Bing, or DuckDuckGo","responses":{"200":{"description":"Ranked organic results, AI Overview citations, and PAA"}}}},"/v1/geo/audit":{"post":{"operationId":"geoLlmVisibilityAudit","summary":"Run a Multi-LLM Citation & Share-of-Voice (GEO) audit across ChatGPT, Perplexity, Claude, Gemini & Grok","responses":{"200":{"description":"GEO Share-of-Voice score, per-engine breakdown, and recommendations"}}}},"/v1/seo/crawl":{"post":{"operationId":"technicalSeoCrawl","summary":"Live HTTP + HTML technical SEO, Schema.org, robots.txt AI crawler & /llms.txt audit","responses":{"200":{"description":"Technical SEO & GEO readiness audit report"}}}},"/v1/keywords/cluster":{"post":{"operationId":"keywordIntentCluster","summary":"Generate search volume, CPC, KD (0-100), buyer intent & pillar-and-spoke keyword clusters","responses":{"200":{"description":"Semantic keyword clusters"}}}},"/v1/backlinks/graph":{"post":{"operationId":"backlinkAuthorityGraph","summary":"Inspect Domain Rating (DR), referring domains, anchor distribution & LLM-cited URLs","responses":{"200":{"description":"Backlink authority & citation graph"}}}},"/v1/markdown/extract":{"post":{"operationId":"markdownCleanExtract","summary":"Convert any live URL into clean, boilerplate-free Markdown for LLM RAG pipelines","responses":{"200":{"description":"Clean Markdown, token count, links, and SHA-256 hash"}}}},"/v1/competitors/matrix":{"post":{"operationId":"competitorGapMatrix","summary":"Compare primary domain vs up to 5 competitors across keyword gaps & LLM Share-of-Voice","responses":{"200":{"description":"Multi-domain competitive gap matrix"}}}},"/v1/schema/generate":{"post":{"operationId":"schemaJsonLdGenerator","summary":"Generate deterministic Schema.org @graph JSON-LD (SoftwareApplication, Organization, FAQPage)","responses":{"200":{"description":"Validated JSON-LD object and HTML script snippet"}}}},"/v1/geo/reputation-writer":{"post":{"operationId":"geoReputationAndWriter","summary":"7-Dimension AI Brand Reputation Audit & Answer-First GEO Writer (with 6-hour response cache)","responses":{"200":{"description":"7D reputation scores, narrative frames, and Answer-First Markdown + HTML table + JSON-LD writer pack"}}}},"/v1/geo/agent-attribution":{"post":{"operationId":"agentCrawlerTrafficAttribution","summary":"3-Tier AI Crawler Readiness & GA4 / Plausible / PostHog AI Traffic Attribution Regex Generator","responses":{"200":{"description":"Training vs Search Indexer vs User-Triggered Agent taxonomy, WAF spoofing verdict, and analytics filters"}}}},"/v1/seo/cms-autopilot":{"post":{"operationId":"cmsAutopilotAndGscSync","summary":"Multi-CMS SEO/GEO Autopilot, GSC Weekly Rank Heartbeat & Shared Action Board Orchestrator","responses":{"200":{"description":"Shared Action Board items sorted by expected_clicks, staged CMS diff, or rollback receipt"}}}},"/v1/auth/register":{"post":{"operationId":"registerAccount","summary":"Zero-browser developer & autonomous agent workspace registration","responses":{"201":{"description":"Workspace, user, and arg_live_... API key provisioned"}}}},"/v1/workspaces":{"post":{"operationId":"createWorkspace","summary":"Create a workspace in one step and receive its first arg_live_... API key","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["workspaceName"],"properties":{"workspaceName":{"type":"string","description":"Display name for the workspace."},"email":{"type":"string","format":"email","description":"Owner email, used to sign in later."},"password":{"type":"string","minLength":8,"description":"Required when email is set."},"name":{"type":"string","description":"Owner display name."}}}}}},"responses":{"201":{"description":"Workspace created; returns workspace, user and API key"},"409":{"description":"An account already exists for this email"}}},"get":{"operationId":"getCurrentWorkspace","summary":"Return the workspace that owns the bearer token","responses":{"200":{"description":"Workspace record"},"401":{"description":"Unknown token"}}}},"/v1/auth/login":{"post":{"operationId":"login","summary":"Sign in with email + password or an existing arg_live_... API key","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"password":{"type":"string"},"apiKey":{"type":"string","description":"An existing arg_live_... key."}}}}}},"responses":{"200":{"description":"Session established; returns workspace and API key"},"401":{"description":"Invalid credentials"}}}},"/v1/account":{"get":{"operationId":"getAccountStatus","summary":"Inspect active workspace plan, quota, BYOK vault, and Stripe Live billing catalog","responses":{"200":{"description":"Workspace account status"}}}},"/v1/billing/checkout":{"post":{"operationId":"createBillingCheckout","summary":"Create a Stripe Live Checkout session (Starter $19/mo, Builder $39/mo, Scale $79/mo)","responses":{"200":{"description":"Stripe Live Checkout session URL and IDs"}}}},"/v1/traffic/analytics":{"get":{"operationId":"getTrafficAnalytics","summary":"Real-time web, REST API & MCP JSON-RPC attribution telemetry (Admin Key Required)","responses":{"200":{"description":"Traffic telemetry report"}}}}},"x-stripe-live-catalog":{"accountId":"acct_1Q2x6wFbCOiTwVKX","accountName":"Allometrik Consulting FZCO","livemode":true,"webhookPath":"/v1/billing/webhook","plans":{"free":{"name":"Argosor Free Sandbox","monthlyUsd":0,"monthlyQueryQuota":250,"includedCreditsUsd":2.5,"stripeProductId":"prod_scrutior_free","stripePriceId":"price_scrutior_free","stripeLookupKey":"scrutior_free","features":["250 live SERP, GEO & Markdown calls/mo included","Unlimited BYOK calls ($0 markup with your own OpenRouter/DataForSEO/SerpApi/Firecrawl/OpenAI keys)","All 15 semantic MCP tools + REST API v1 + Agent Skills included","All 9+ AI engines included (ChatGPT, Perplexity, Claude, AI Overviews, AI Mode, Gemini, Grok, DeepSeek, Copilot)"]},"starter":{"name":"Argosor Starter","monthlyUsd":19,"monthlyQueryQuota":25000,"includedCreditsUsd":19,"stripeProductId":"prod_VW67p4BVyfai0a","stripePriceId":"price_1UV3xmFbCOiTwVKXHCYsa2XJ","stripeLookupKey":"scrutior_starter_monthly","features":["25,000 Managed SERP / Markdown / Technical SEO calls/mo ($0.0005/call)","1,500 Managed GEO Multi-LLM Citation & Reputation Audits/mo across all 9+ AI engines (no per-model add-on fees)","Full REST API v1 + 15-Tool MCP Server included on Starter (vs €299/mo on LLM Pulse)","Unlimited BYOK execution at $0 markup (OpenRouter, Perplexity, OpenAI, Anthropic, Gemini, DeepSeek, Grok)"]},"builder":{"name":"Argosor Builder","monthlyUsd":39,"monthlyQueryQuota":75000,"includedCreditsUsd":45,"stripeProductId":"prod_VW67x9Y6HyueDE","stripePriceId":"price_1UV3xZFbCOiTwVKXHscwjOBl","stripeLookupKey":"scrutior_builder_monthly","features":["75,000 Managed SERP / Markdown / Technical SEO calls/mo (70% cheaper than DataForSEO/SerpApi)","5,000 Managed GEO Multi-LLM Citation, 7D Reputation & Answer-First Writer calls/mo","Backlink Authority Graphs, Competitor Gap Matrices & AI Crawler Attribution Regex","Unlimited BYOK execution at $0 markup + Priority Edge Queue"]},"scale":{"name":"Argosor Scale","monthlyUsd":79,"monthlyQueryQuota":250000,"includedCreditsUsd":100,"stripeProductId":"prod_VW67l6QFj3tPe7","stripePriceId":"price_1UV3xZFbCOiTwVKX86l1tXPy","stripeLookupKey":"scrutior_scale_monthly","features":["250,000 Managed SERP / Markdown / Technical SEO calls/mo","20,000 Managed GEO Multi-LLM Citation, 7D Reputation & Agent Attribution Audits/mo","Unlimited workspaces, team API keys & AES-256-GCM BYOK profiles","Dedicated high-concurrency rate limits & 99.99% Global Edge SLA"]}}}}