{ "openapi": "3.1.0", "info": { "title": "AKI Platform Global AI Intelligence API", "version": "2026.8.14", "description": "Production REST & MCP API Gateway for 1,000+ AI tools, autonomous agent frameworks, physical robotics, sovereign AI spend, and verified job markets.", "contact": { "name": "AKI Platform Engineering Team", "url": "https://aki1k.com", "email": "team@aki1k.com" } }, "servers": [ { "url": "https://api.aki1k.com", "description": "Global Production Edge Gateway" } ], "paths": { "/openapi.json": { "get": { "summary": "Get OpenAPI 3.1.0 Specification", "description": "Returns the complete OpenAPI 3.1.0 specification for all AKI API endpoints.", "responses": { "200": { "description": "OpenAPI 3.1.0 JSON Schema", "headers": { "x-ratelimit-limit": { "schema": { "type": "integer", "example": 500 } }, "cache-control": { "schema": { "type": "string", "example": "public, max-age=3600" } } } } } } }, "/v1/tools": { "get": { "summary": "Query top 1,000 audited AI tools", "description": "Returns paginated tool records with 95% confidence bounds, monthly traffic, and category classifications.", "parameters": [ { "name": "limit", "in": "query", "description": "Maximum number of tools to return", "schema": { "type": "integer", "default": 100 } }, { "name": "category", "in": "query", "description": "Category filter (e.g., 'Agentic IDE', 'Reasoning LLM')", "schema": { "type": "string" } }, { "name": "search", "in": "query", "description": "Search query for tool name, domain, or tag", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Top AI tools array with telemetry", "headers": { "x-ratelimit-limit": { "schema": { "type": "integer", "example": 500 } }, "cache-control": { "schema": { "type": "string", "example": "public, max-age=60, s-maxage=300" } } } } } } }, "/v1/viral/latest": { "get": { "summary": "Viral 15 Real-Time Trending AI Tools", "description": "Rolling 15-minute viral momentum detection capturing sudden traffic and search spikes.", "responses": { "200": { "description": "Real-time viral tools stream" } } } }, "/v1/companies-100": { "get": { "summary": "AKI AI Companies 100", "description": "Top 100 AI enterprise entities with funding rounds, valuations, and employee headcount.", "responses": { "200": { "description": "100 AI enterprise company profiles" } } } }, "/v1/research/company-leadership": { "get": { "summary": "100 Audited AI Labs Leadership & Compute Index", "description": "Frontier AI lab rankings, compute cluster allocations, and institutional citations.", "responses": { "200": { "description": "100 AI research labs and leadership entities" } } } }, "/v1/research/radar": { "get": { "summary": "Research Radar Emerging Signals", "description": "Frontier algorithmic themes, lab attributions, and 12-month momentum curves.", "responses": { "200": { "description": "Research radar signals array" } } } }, "/v1/research/labs": { "get": { "summary": "AI Research Labs Benchmark Directory", "description": "Audited lab profiles with H-index scores, open source weights, and publication counts.", "responses": { "200": { "description": "Audited research labs array" } } } }, "/v1/finance/dividend-index": { "get": { "summary": "AI Dividend 100 Equities", "description": "Top 100 AI dividend equities with yield telemetry, 5Y growth CAGRs, and AI exposure scores.", "responses": { "200": { "description": "100 AI dividend equities array" } } } }, "/v1/physical-ai": { "get": { "summary": "Physical AI & Robotics 100", "description": "Embodied robotics, humanoids, and AMRs with verified operating fleet hours.", "responses": { "200": { "description": "100 Physical AI and robotics systems" } } } }, "/v1/future-ai": { "get": { "summary": "Future AI & Frontier Systems 100", "description": "Frontier AI entities across Quantum AI, Neurosymbolic, DNA Storage, and Optical Compute.", "responses": { "200": { "description": "100 Future AI frontier systems" } } } }, "/v1/future-ai/quantum": { "get": { "summary": "Quantum AI 100 Dedicated Sub-System", "description": "Logical qubit counts, quantum hardware scores, and quantum error correction metrics.", "responses": { "200": { "description": "100 Quantum AI entities array" } } } }, "/v1/finance/crypto-index": { "get": { "summary": "AI Crypto & Agent Rails 100", "description": "Autonomous agent money standards, transaction latency, and throughput economics.", "responses": { "200": { "description": "100 AI crypto protocols and agent payment rails" } } } }, "/v1/radar": { "get": { "summary": "Live AI Traffic Radar & Migration Index", "description": "Day-over-day web traffic migration and search spikes across 25 top AI tools.", "responses": { "200": { "description": "25 top traffic gainers with range estimation" } } } }, "/v1/jobs": { "get": { "summary": "Get all active verified AI careers (Direct ATS Ingestion)", "description": "Indexes open careers across 1,000+ audited AI companies directly from official ATS feeds (Greenhouse, Lever, Ashby).", "parameters": [ { "name": "q", "in": "query", "description": "Search keyword for job title, skills, or company", "schema": { "type": "string" } }, { "name": "category", "in": "query", "description": "Filter by functional bucket", "schema": { "type": "string" } }, { "name": "remote", "in": "query", "description": "Filter for remote-only roles", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "List of verified AI jobs" } } } }, "/v1/jobs/submit": { "post": { "summary": "Submit AI Job Listing for AKI Verification", "description": "Direct REST submission endpoint for employers and ATS pipelines. Rate limited to 10 submissions/hour per IP.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "company_name", "employer_email", "role_title", "apply_url" ], "properties": { "company_name": { "type": "string" }, "employer_email": { "type": "string", "format": "email" }, "role_title": { "type": "string" }, "category": { "type": "string" }, "location": { "type": "string" }, "is_remote": { "type": "boolean" }, "salary_min": { "type": "integer" }, "salary_max": { "type": "integer" }, "salary_currency": { "type": "string" }, "apply_url": { "type": "string", "format": "uri" }, "experience_tier": { "type": "string" } } } } } }, "responses": { "201": { "description": "Job submission received and queued for verification" }, "400": { "description": "Validation error" }, "429": { "description": "Rate limit exceeded" } } } }, "/v1/jobs/verified": { "get": { "summary": "Get approved and verified AI job listings", "description": "Returns only approved, verified AI job listings audited by AKI Research.", "responses": { "200": { "description": "Verified AI jobs list" } } } }, "/v1/jobs/hiring-countries": { "get": { "summary": "AI Hiring Countries 20", "description": "Top 20 nations ranked by AI hiring intensity, salary, and job volume share.", "responses": { "200": { "description": "20 top AI hiring countries dataset" } } } }, "/v1/jobs/displacement": { "get": { "summary": "AI Displacement 100", "description": "Occupations evaluated for task substitution velocity and automation risk.", "responses": { "200": { "description": "20+ task-shifted occupations dataset" } } } }, "/v1/jobs/creation": { "get": { "summary": "AI Creation 100", "description": "Emerging frontier AI job titles with YoY demand acceleration.", "responses": { "200": { "description": "20+ emerging AI roles dataset" } } } }, "/v1/jobs/remote": { "get": { "summary": "Global AI Remote Jobs Index", "description": "Remote vacancy counts and work-from-anywhere readiness per nation.", "responses": { "200": { "description": "20 remote AI job market corridors" } } } }, "/v1/jobs/freelance": { "get": { "summary": "AI Freelance Demand Index", "description": "Top freelance skills with project value averages and competition ratios.", "responses": { "200": { "description": "20 freelance skills and market rates" } } } }, "/v1/jobs/expert": { "get": { "summary": "AI Expert Scarcity Index", "description": "Specialist roles with time-to-fill and talent scarcity ratios.", "responses": { "200": { "description": "20 specialist roles and scarcity benchmarks" } } } }, "/v1/jobs/graduates": { "get": { "summary": "AI Graduate & Entry-Level Jobs", "description": "0-2 Yrs experience roles with entry compensation benchmarks.", "responses": { "200": { "description": "20 entry-level and graduate AI roles" } } } }, "/v1/mcp": { "post": { "summary": "Model Context Protocol JSON-RPC Server", "description": "Executes tools/list and tools/call for Model Context Protocol clients.", "responses": { "200": { "description": "MCP JSON-RPC response", "headers": { "x-ratelimit-limit": { "schema": { "type": "integer", "example": 500 } } } } } } }, "/sitemap.xml": { "get": { "summary": "Dynamic XML Sitemap for Search & AI Crawlers", "responses": { "200": { "description": "XML Sitemap Output" } } } } } }