{"openapi":"3.1.0","info":{"title":"HabibiAccounts public read API","version":"2026-08-26","summary":"Read-only, unauthenticated endpoints describing live account inventory and recorded price history.","description":"These endpoints exist so assistants and agents can read the store without scraping HTML. Everything here is public, read-only and safe to cache for a few minutes. Purchasing requires a signed-in session and is not part of this document.","termsOfService":"https://habibiaccounts.com/terms","contact":{"name":"HabibiAccounts support","email":"support@habibiaccounts.com","url":"https://habibiaccounts.com/for-ai"}},"servers":[{"url":"https://habibiaccounts.com"}],"paths":{"/ask":{"get":{"operationId":"ask","summary":"Answer a plain-language question about inventory or prices (NLWeb).","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","maxLength":300}},{"name":"locale","in":"query","required":false,"description":"Use locale, not lang: ?lang= is 301-redirected to the /ar/ path prefix site-wide.","schema":{"type":"string","enum":["en","ar"]}}],"responses":{"200":{"description":"A schema.org SearchResultsPage with a quotable summary and ranked categories.","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"askPost","summary":"Same as GET /ask with a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","maxLength":300},"locale":{"type":"string","enum":["en","ar"]}}}}}},"responses":{"200":{"description":"A schema.org SearchResultsPage.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/catalog.json":{"get":{"operationId":"getCatalog","summary":"Full live catalog: categories, live listing counts, stocked titles and guide URLs.","responses":{"200":{"description":"The catalog document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/price-index.json":{"get":{"operationId":"getPriceIndex","summary":"Recorded daily price history per category, with 30-day change.","responses":{"200":{"description":"The price index document, including its methodology statement.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/acp/product-feed.json":{"get":{"operationId":"getAcpProductFeed","summary":"Agentic Commerce Protocol product feed for shopping-agent discovery.","responses":{"200":{"description":"The ACP product feed.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp":{"post":{"operationId":"mcpJsonRpc","summary":"Model Context Protocol endpoint (JSON-RPC 2.0) exposing typed inventory and price tools.","responses":{"200":{"description":"A JSON-RPC 2.0 response.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}