{"openapi":"3.1.0","info":{"title":"WISE Lens API","version":"2026-11-10","description":"Read your WISE Lens figures, answers, brands, sites and analysis. Read only; one business per key.","contact":{"email":"support@aiwise.sg"}},"servers":[{"url":"https://aiseo.aiwise.sg"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A WISE Lens API key (wl_…), made under Connections › API keys"}}},"paths":{"/api/lens/v1/daily":{"get":{"summary":"Day by day","description":"One row per day, AI and question — whether and where each AI named you, quoted your site, and how it spoke of you.","operationId":"daily","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"First day, YYYY-MM-DD (default: the first day measured)"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Last day, YYYY-MM-DD (default: the last day measured)"}],"responses":{"200":{"description":"The rows","content":{"application/json":{"schema":{"type":"object","properties":{"business":{"type":"string"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"object","properties":{"Date":{"type":"string"},"AI":{"type":"string"},"Kind of question":{"type":"string"},"Question":{"type":"string"},"Answers":{"type":"integer"},"Shown":{"type":"integer"},"Named":{"type":"integer"},"Named first":{"type":"integer"},"Named 2nd or 3rd":{"type":"integer"},"Named 4th or lower":{"type":"integer"},"Named in passing":{"type":"integer"},"Read for sources":{"type":"integer"},"Your site quoted":{"type":"integer"},"Brand mentions":{"type":"integer"},"Positive":{"type":"integer"},"Negative":{"type":"integer"}}}}}}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"No key, a key that is not known or was revoked, or the business's WISE Lens is switched off.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"The business's plan does not include the API.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"This minute's or this month's calls are used.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a call will be counted again"}}},"500":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/lens/v1/answers":{"get":{"summary":"Every answer","description":"Every answer, with its words — streamed, so a long period is fine. JSON is a list of rows.","operationId":"answers","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"First day, YYYY-MM-DD (default: the first day measured)"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Last day, YYYY-MM-DD (default: the last day measured)"}],"responses":{"200":{"description":"The rows","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"Date":{"type":"string"},"AI":{"type":"string"},"Question":{"type":"string"},"Kind of question":{"type":"string"},"Named":{"type":"string"},"Place":{"type":"string"},"Your site quoted":{"type":"string"},"Sites quoted":{"type":"string"},"Businesses named":{"type":"string"},"Answer":{"type":"string"}}}}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"No key, a key that is not known or was revoked, or the business's WISE Lens is switched off.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"The business's plan does not include the API.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"This minute's or this month's calls are used.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a call will be counted again"}}},"500":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/lens/v1/brands":{"get":{"summary":"Brands named","description":"One row per day, AI, question and brand named — your own marked You.","operationId":"brands","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"First day, YYYY-MM-DD (default: the first day measured)"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Last day, YYYY-MM-DD (default: the last day measured)"}],"responses":{"200":{"description":"The rows","content":{"application/json":{"schema":{"type":"object","properties":{"business":{"type":"string"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"object","properties":{"Date":{"type":"string"},"AI":{"type":"string"},"Kind of question":{"type":"string"},"Question":{"type":"string"},"Brand":{"type":"string"},"You":{"type":"string"},"Answers naming it":{"type":"integer"}}}}}}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"No key, a key that is not known or was revoked, or the business's WISE Lens is switched off.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"The business's plan does not include the API.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"This minute's or this month's calls are used.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a call will be counted again"}}},"500":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/lens/v1/sites":{"get":{"summary":"Sites quoted","description":"One row per day, AI, question and page quoted — the site alone when the AI gave no page.","operationId":"sites","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"First day, YYYY-MM-DD (default: the first day measured)"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Last day, YYYY-MM-DD (default: the last day measured)"}],"responses":{"200":{"description":"The rows","content":{"application/json":{"schema":{"type":"object","properties":{"business":{"type":"string"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"object","properties":{"Date":{"type":"string"},"AI":{"type":"string"},"Kind of question":{"type":"string"},"Question":{"type":"string"},"Site":{"type":"string"},"Page":{"type":"string"},"Your site":{"type":"string"},"Answers quoting it":{"type":"integer"}}}}}}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"No key, a key that is not known or was revoked, or the business's WISE Lens is switched off.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"The business's plan does not include the API.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"This minute's or this month's calls are used.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a call will be counted again"}}},"500":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/lens/v1/analysis":{"get":{"summary":"Analysis","description":"One part of WISE Lens's analysis as JSON — the part your AI assistant reads. Without a section, the list of sections.","operationId":"analysis","parameters":[{"name":"section","in":"query","required":false,"schema":{"type":"string","enum":["summary","known_for","sentiment","sources","questions","products","site_read","google_bing","ads","visitors","reports"]}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30}}],"responses":{"200":{"description":"The section as JSON, or the list of sections","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"/analysis was asked for a section that does not exist. The reply lists the sections.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"No key, a key that is not known or was revoked, or the business's WISE Lens is switched off.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"The business's plan does not include the API.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"This minute's or this month's calls are used.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until a call will be counted again"}}},"500":{"description":"Something failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}