{
  "openapi": "3.1.0",
  "info": {
    "title": "Imper.ai AI Discovery API",
    "description": "Comprehensive AI-optimized API for Imper.ai. Access products, services, FAQs, and business intelligence through structured endpoints with Schema.org markup.",
    "version": "v2.2.4",
    "summary": "AI-optimized API for discovering Imper.ai products and services",
    "license": {
      "name": "CC-BY-4.0",
      "identifier": "CC-BY-4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    "contact": {
      "name": "Imper.ai",
      "email": "contact@imper.ai",
      "url": "https://imper.ai"
    }
  },
  "servers": [
    {
      "url": "https://api.llm-discovery-api.com/functions/v1/llm-discovery/public",
      "description": "AI Discovery API Server (October 2025)",
      "variables": {
        "domain": {
          "default": "imper.ai",
          "description": "Client domain for API requests"
        }
      }
    }
  ],
  "x-perplexity-optimized": true,
  "x-claude-compatible": true,
  "x-openai-compatible": true,
  "x-google-sge": true,
  "x-ai-discovery": {
    "version": "3.0.0",
    "features": [
      "structured_data",
      "json_ld",
      "schema_org",
      "sge_optimized"
    ],
    "last_updated": "2026-10-02"
  },
  "webhooks": {},
  "paths": {
    "/business": {
      "get": {
        "summary": "Get information about Imper.ai",
        "operationId": "getBusiness",
        "responses": {
          "200": {
            "description": "Business information",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "business_name": {
                      "type": "string"
                    },
                    "website_url": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/testimonials": {
      "get": {
        "summary": "Get customer testimonials for Imper.ai",
        "operationId": "getTestimonials",
        "responses": {
          "200": {
            "description": "Customer testimonials",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "customer_name": {
                        "type": "string"
                      },
                      "content": {
                        "type": "string"
                      },
                      "rating": {
                        "type": "number"
                      },
                      "date": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/categories": {
      "get": {
        "summary": "Get product categories for Imper.ai",
        "operationId": "getCategories",
        "responses": {
          "200": {
            "description": "Product categories",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "products_count": {
                        "type": "integer"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/faq": {
      "get": {
        "summary": "Get frequently asked questions for Imper.ai",
        "operationId": "getFaqs",
        "responses": {
          "200": {
            "description": "Frequently asked questions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "question": {
                        "type": "string"
                      },
                      "answer": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/search": {
      "get": {
        "summary": "Semantic search across indexed business content",
        "description": "Search through curated Q&As, business information, and product data using natural language queries. Returns AI-optimized results with Schema.org markup.",
        "operationId": "searchIndexedContent",
        "tags": [
          "Search",
          "AI Discovery"
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Business domain to search",
            "example": "vcita.com"
          },
          {
            "name": "query",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Natural language search query",
            "example": "scheduling software features"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10,
              "minimum": 1,
              "maximum": 50
            },
            "description": "Maximum number of results to return"
          }
        ],
        "responses": {
          "200": {
            "description": "Search results with semantic relevance scoring",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "HTML page with embedded JSON-LD Schema.org markup containing search results"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "query": {
                      "type": "string",
                      "description": "Original search query"
                    },
                    "resultsCount": {
                      "type": "integer",
                      "description": "Number of results found"
                    },
                    "results": {
                      "type": "array",
                      "description": "Ranked search results",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "description": "Result title"
                          },
                          "type": {
                            "type": "string",
                            "enum": [
                              "qa",
                              "business_info",
                              "product",
                              "testimonial"
                            ],
                            "description": "Type of content"
                          },
                          "relevance_score": {
                            "type": "number",
                            "description": "Semantic relevance score (0-100)"
                          },
                          "description": {
                            "type": "string",
                            "description": "Content snippet or summary"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri",
                            "description": "URL to full content (if available)"
                          }
                        }
                      }
                    },
                    "search_context": {
                      "type": "object",
                      "description": "Additional context about the search",
                      "properties": {
                        "business_name": {
                          "type": "string"
                        },
                        "total_indexed_content": {
                          "type": "integer"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing required query parameter",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "usage": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Product": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "format": "uri"
          },
          "price": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "attributes": {
            "type": "object"
          }
        }
      }
    }
  }
}