Skip to the page
WISE Lensby AI WISE
Start free trial
All guides

All connections

WISE Lens API

Read your WISE Lens from your own software: your figures, every AI answer, the brands and sites the AIs named, and WISE Lens's analysis. It only reads — nothing you send can change your WISE Lens.

Overview

Who has it
Every plan. Your AI assistant reads WISE Lens on every plan — see AI assistants (MCP).
Base address
https://aiseo.aiwise.sg/api/lens/v1
Format
JSON over HTTPS by default; CSV with format=csv.
Access
Read only. One key reads one business — the one it was made for.
Description
openapi.json — every endpoint, for Postman or a code generator.

Quick start

  1. In WISE Lens, open Connections › API keys › Create a key, type what the key is for and choose Make a key. Copy it now: it is shown once.
  2. Put it in your terminal (it starts wl_): export WISELENS_KEY=wl_…your key…
  3. Ask for the list of analysis sections — it answers with JSON:
curl
curl -H "Authorization: Bearer $WISELENS_KEY" "https://aiseo.aiwise.sg/api/lens/v1/analysis"

Authentication

Send the key with every request, in the header Authorization: Bearer <your key>. Never put it in an address.

  • Make one: Connections › API keys › Create a key, then Make a key. Name it for what it feeds (“Looker Studio”, “Finance warehouse”).
  • Shown once: we keep only a fingerprint of it, so it cannot be shown again. Lost it? Make a new one.
  • See them: the same place lists each key by name and first characters, who made it, and when it was last used.
  • Revoke: Connections › API keys › Manage keys › Revoke beside the key. It stops at once.
  • Keep it safe: one key per tool, in a secret store or an environment variable, never in a browser’s code.

Concepts

Days
from and to as YYYY-MM-DD, both included, both optional: the whole history by default.
When a day is ready
We ask at 1 a.m. Singapore time and collect the answers every hour until 7:30 a.m.; the day's summary is ready by 9 a.m.
Shown and named
“Answers” counts every question asked; “Shown” leaves out a search where Google gave no AI answer. WISE Lens’s share is Named ÷ Shown.
Paging
None: one request returns the whole range. Every answer is streamed, so a long range is fine.
Tables in JSON
{ business, from, to, columns, rows }; every answer is a plain list of rows.
CSV
UTF-8 with a byte-order mark, so Excel reads the accents; the first row is the column names.

Rate limits

Every request is one call from your business’s monthly allowance, shared by every key and every channel. The month is your own — from the day you started to the same day of the next month, not from the 1st. There is no hourly limit; the per-minute figure is a burst cap, so one busy minute cannot slow the dashboards everyone shares.

PlanCalls a monthAt most a minuteAI credits a month
S$150 a month5,00060100
S$300 a month25,000120200
S$500 a month100,000300400
Done-for-you, S$1,500 a month100,000300400
Done-for-you, S$3,000 a month200,000300800
Done-for-you, S$5,500 a month400,0003001,600
  • Past either limit the API answers 429 with a Retry-After header: the seconds until a call is counted again. Wait that long; do not retry sooner.
  • The reply’s error says which limit and when the calls come back. No other rate headers are sent.
  • Need more this month? S$10 for 10,000 more calls, under Connections › API keys. A dashboard refreshing once a day uses about 30 calls a month per table.

Errors

A refusal is JSON: { "error": "…what happened, in words…" }.

StatusWhat it meansWhat to do
400/analysis was asked for a section that does not exist. The reply lists the sections.Use a section from the list.
401No key, a key that is not known or was revoked, or the business's WISE Lens is switched off.Send Authorization: Bearer with an open key; make a new one if it was revoked.
403The business's plan does not include the API.Move to a plan with the API, or ask your AI assistant instead (every plan).
429This minute's or this month's calls are used.Wait the seconds in the Retry-After header; the error says when the calls come back.
500Something failed on our side.Try again in a minute; if it repeats, write to us with the time.

Endpoints

Every table takes format (json or csv), from and to.

Day by day · GET /api/lens/v1/daily

One row per day, AI and question — whether and where each AI named you, quoted your site, and how it spoke of you.

Columns: Date · AI · Kind of question · Question · Answers · Shown · Named · Named first · Named 2nd or 3rd · Named 4th or lower · Named in passing · Read for sources · Your site quoted · Brand mentions · Positive · Negative

curl -H "Authorization: Bearer $WISELENS_KEY" "https://aiseo.aiwise.sg/api/lens/v1/daily?from=2026-11-01&to=2026-11-07"
The reply (JSON, one row shown)
{
  "business": "example.com",
  "from": "2026-11-03",
  "to": "2026-11-09",
  "columns": ["Date", "AI", "Kind of question", "Question", "Answers", "Shown", "Named", "Named first", "Named 2nd or 3rd", "Named 4th or lower", "Named in passing", "Read for sources", "Your site quoted", "Brand mentions", "Positive", "Negative"],
  "rows": [
    {
      "Date": "2026-11-09",
      "AI": "ChatGPT",
      "Kind of question": "Best options",
      "Question": "Which digital agency in Singapore is best for small businesses?",
      "Answers": 3,
      "Shown": 3,
      "Named": 1,
      "Named first": 1,
      "Named 2nd or 3rd": 1,
      "Named 4th or lower": 1,
      "Named in passing": 1,
      "Read for sources": 1,
      "Your site quoted": 1,
      "Brand mentions": 1,
      "Positive": 1,
      "Negative": 1
    }
  ]
}

Every answer · GET /api/lens/v1/answers

Every answer, with its words — streamed, so a long period is fine. JSON is a list of rows.

Columns: Date · AI · Question · Kind of question · Named · Place · Your site quoted · Sites quoted · Businesses named · Answer

curl -H "Authorization: Bearer $WISELENS_KEY" "https://aiseo.aiwise.sg/api/lens/v1/answers?from=2026-11-01&to=2026-11-07"
The reply (JSON, one row shown)
[
  {
    "Date": "2026-11-09",
    "AI": "ChatGPT",
    "Question": "Which digital agency in Singapore is best for small businesses?",
    "Kind of question": "Best options",
    "Named": "Yes",
    "Place": "First",
    "Your site quoted": "No",
    "Sites quoted": "example.com; another.com",
    "Businesses named": "Example Co; Another Co",
    "Answer": "Here are three agencies to consider…"
  }
]

Brands named · GET /api/lens/v1/brands

One row per day, AI, question and brand named — your own marked You.

Columns: Date · AI · Kind of question · Question · Brand · You · Answers naming it

curl -H "Authorization: Bearer $WISELENS_KEY" "https://aiseo.aiwise.sg/api/lens/v1/brands?from=2026-11-01&to=2026-11-07"
The reply (JSON, one row shown)
{
  "business": "example.com",
  "from": "2026-11-03",
  "to": "2026-11-09",
  "columns": ["Date", "AI", "Kind of question", "Question", "Brand", "You", "Answers naming it"],
  "rows": [
    {
      "Date": "2026-11-09",
      "AI": "ChatGPT",
      "Kind of question": "Best options",
      "Question": "Which digital agency in Singapore is best for small businesses?",
      "Brand": "Example Co",
      "You": "No",
      "Answers naming it": 1
    }
  ]
}

Sites quoted · GET /api/lens/v1/sites

One row per day, AI, question and page quoted — the site alone when the AI gave no page.

Columns: Date · AI · Kind of question · Question · Site · Page · Your site · Answers quoting it

curl -H "Authorization: Bearer $WISELENS_KEY" "https://aiseo.aiwise.sg/api/lens/v1/sites?from=2026-11-01&to=2026-11-07"
The reply (JSON, one row shown)
{
  "business": "example.com",
  "from": "2026-11-03",
  "to": "2026-11-09",
  "columns": ["Date", "AI", "Kind of question", "Question", "Site", "Page", "Your site", "Answers quoting it"],
  "rows": [
    {
      "Date": "2026-11-09",
      "AI": "ChatGPT",
      "Kind of question": "Best options",
      "Question": "Which digital agency in Singapore is best for small businesses?",
      "Site": "example.com",
      "Page": "https://example.com/guide",
      "Your site": "No",
      "Answers quoting it": 1
    }
  ]
}

Analysis · GET /api/lens/v1/analysis

One part of WISE Lens's analysis as JSON — the part your AI assistant reads. Without a section, the list of sections.

section=What comes back
summaryDaily summaries and verdicts. WISE Lens's written summary of each recent day — what moved and what to do — and its one-sentence verdict on each card of the dashboard.
known_forKnown for. The qualities the AIs credit the business and its competitors with, and the reasons they give against the business.
sentimentSentiment. How the answers that name the business speak of it — positive, neutral, negative — overall, by AI and by question.
sourcesSites and pages the AIs quote. The sites and pages the AIs quoted over the last 30 days (or days=), with how many answers quoted each and what kind of site it is; the business's own pages marked.
questionsQuestions. Every buyer question WISE Lens asks: its words, its kind, how often it is searched, and over the last 30 days (or days=) how often the business was named for it.
productsProducts named. The products the AIs named over the last 30 days (or days=), the business's own marked, with how many answers named each.
site_readCan AI read your site. Whether AI crawlers can reach the site, how each page reads to them, what to fix, and the site's health.
google_bingGoogle and Bing. The business's Google search figures, Microsoft's AI citing its site, and where it ranks for its questions.
adsAds beside the AI answers. Which advertisers show beside the AI answers to the business's questions, and how often.
visitorsAI visitors and enquiries. Visits AI assistants sent to the site, where those visitors landed, and enquiries with how they found the business.
reportsReports. The weekly AI SEO reports, the monthly reviews and the monthly SEO reports shared with the business — each with its figures and its link.
curl -H "Authorization: Bearer $WISELENS_KEY" "https://aiseo.aiwise.sg/api/lens/v1/analysis?section=sentiment&days=30"

Recipes

Rebuild the Overview’s share named

Sum Named and Shown over the days at the top of your WISE Lens, then divide. The result is the figure the Overview prints.

Python
import os, requests

H = {"Authorization": f"Bearer {os.environ['WISELENS_KEY']}"}
rows = requests.get("https://aiseo.aiwise.sg/api/lens/v1/daily", params={"from": "2026-11-03", "to": "2026-11-09"}, headers=H).json()["rows"]
named = sum(r["Named"] for r in rows)
shown = sum(r["Shown"] for r in rows)
print(f"Named in {named} of {shown} answers: {named / shown:.1%}")

The same, by AI

Python
from collections import defaultdict

by_ai = defaultdict(lambda: [0, 0])
for r in rows:
    by_ai[r["AI"]][0] += r["Named"]
    by_ai[r["AI"]][1] += r["Shown"]
for ai, (n, s) in by_ai.items():
    print(ai, f"{n / s:.1%}" if s else "—")

Who is named instead of you

/api/lens/v1/brands lists every brand per day, AI and question; sum “Answers naming it” by Brand and sort. Your own row says You.

Built on the API

OpenAPI file

https://aiseo.aiwise.sg/lens/api/openapi.json describes every endpoint, its parameters, its replies and its refusals, made from the same code that serves them. Import it into Postman (Import › Link) or a client generator.

Changelog

Version 2026-11-10. Nothing has been removed or changed in a way that breaks a request.

DayKindWhat changed
10 Nov 2026AddedThis documentation, and the OpenAPI file at /lens/api/openapi.json.
3 Nov 2026Changed/daily counts Named first by the dashboard's rule (first in the list of brands) and adds Named 2nd or 3rd, Named 4th or lower and Named in passing.
1 Nov 2026AddedOne monthly allowance per business, shared by every key and AI assistant: 429 with Retry-After when the hour's or the month's calls are used; extra calls can be bought.
31 Oct 2026Added/analysis: eleven sections of WISE Lens's analysis as JSON. /brands and /sites: the brands named and the pages quoted, per day, AI and question.
29 Oct 2026AddedRead-only API keys, /daily and /answers, as JSON or CSV.

Questions: support@aiwise.sg