Welcome to AskAgento API

Askagento HTTP API

Authentication:

• X-Askagento-Site-Id: <site_id>
• X-Askagento-Api-Key: <api_key>

Every request except POST /install and OPTIONS preflights requires authentication.

Routes:

• OPTIONS /chatbot — CORS preflight; no API key.
• POST /chatbot — AI Chatbot. Chatbot with retrieved product context (LLM; response includes products_retrieved).
• OPTIONS /filter — CORS preflight; no API key.
• POST /filter — Auto Filter. Attributes filters with mode=attributes.
• POST /install — accept installation (async); no API key; response includes new site_id and api_key.
• GET /install — install status.
• OPTIONS /label — CORS preflight; no API key.
• POST /label — Auto Label. Analyze / generate / upload / export auto-labels for attributes, categories, or tags.
• OPTIONS /mcp — CORS preflight; no API key.
• POST /mcp — AI Agents MCP. JSON-RPC 2.0 MCP endpoint; tools: chat_with_shop, get_catalogue_stats, get_featured_products, get_product_by_id, get_shop_status, get_similar_products, list_categories, list_tags, search_products.
• GET /plan — current billing plan.
• GET /recommend/cross-sell — AI Recommend cross-sell bundle.
• GET /recommend/upsell — AI Recommend upsell bundle.
• OPTIONS /search — CORS preflight; no API key.
• POST /search — AI Image or Text Search. Semantic text/image search.
• POST /update — push current catalogue product data for an installed site.
• POST /uninstall — tear down remote data for the authenticated site.
• GET /usage — plan, remaining limits, and tier maximums.