Improvado

Improvado Public Agent Ask API

Free, unauthenticated plain-text question endpoint for AI agents. POST a question and receive a cited plain-text answer about marketing data architecture, connectors, pipelines, attribution and MCP design, carrying a request id and an optional continuation URL. Improvado publishes an OpenAPI 3.1.0 description of it, advertises it from its llms.txt and describes the flow in an agents.json discovery manifest. Public product and architecture questions only — no credentials or customer data may be sent, and abusive bulk traffic may be throttled.

GitHub OpenAPI

Documentation

📖
Documentation
https://improvado.io/llms.txt
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/authentication/improvado-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/rate-limits/improvado-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/openapi/improvado-agent-ask-openapi.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/overlays/improvado-agent-ask-overlay.yaml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/llms/improvado-site-llms.txt
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/errors/improvado-error-codes.yml

OpenAPI Specification

improvado-agent-ask-openapi.json Raw ↑ 
{
  "openapi": "3.1.0",
  "info": {
    "title": "Improvado Public Agent Ask API",
    "version": "1.0.0",
    "description": "Free public plain-text question endpoint for AI agents. Ask a question and get a cited answer about marketing data architecture, connectors, pipelines, attribution, and MCP design. This endpoint is open and does not require authentication.",
    "termsOfService": "https://improvado.io/legal/terms-of-use",
    "contact": {
      "url": "https://improvado.io/register/talk-to-an-expert"
    }
  },
  "servers": [
    {
      "url": "https://agent.improvado.io"
    }
  ],
  "paths": {
    "/ask": {
      "post": {
        "summary": "Ask a plain-text question and receive a cited plain-text answer",
        "requestBody": {
          "required": true,
          "content": {
            "text/plain": {
              "schema": {
                "type": "string"
              },
              "example": "Page: https://improvado.io/blog/marketing-channels \nQuestion: Which ad platforms does Improvado support natively?"
            }
          }
        },
        "responses": {
          "200": {
            "description": "Plain-text cited answer including a request id and optional continuation URL",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Malformed request"
          },
          "429": {
            "description": "Rate limited. Abusive or automated bulk traffic may be throttled; retry later."
          }
        }
      }
    }
  },
  "externalDocs": {
    "url": "https://improvado.io/llms.txt"
  }
}