All guides
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
- 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.
- Put it in your terminal (it starts
wl_):export WISELENS_KEY=wl_…your key… - Ask for the list of analysis sections — it answers with JSON:
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
fromandtoasYYYY-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.
| Plan | Calls a month | At most a minute | AI credits a month |
|---|---|---|---|
| S$150 a month | 5,000 | 60 | 100 |
| S$300 a month | 25,000 | 120 | 200 |
| S$500 a month | 100,000 | 300 | 400 |
| Done-for-you, S$1,500 a month | 100,000 | 300 | 400 |
| Done-for-you, S$3,000 a month | 200,000 | 300 | 800 |
| Done-for-you, S$5,500 a month | 400,000 | 300 | 1,600 |
- Past either limit the API answers 429 with a
Retry-Afterheader: the seconds until a call is counted again. Wait that long; do not retry sooner. - The reply’s
errorsays 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…" }.
| Status | What it means | What to do |
|---|---|---|
| 400 | /analysis was asked for a section that does not exist. The reply lists the sections. | Use a section from the list. |
| 401 | No 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. |
| 403 | The business's plan does not include the API. | Move to a plan with the API, or ask your AI assistant instead (every plan). |
| 429 | This 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. |
| 500 | Something 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"{
"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"[
{
"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"{
"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"{
"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 |
|---|---|
summary | Daily 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_for | Known for. The qualities the AIs credit the business and its competitors with, and the reasons they give against the business. |
sentiment | Sentiment. How the answers that name the business speak of it — positive, neutral, negative — overall, by AI and by question. |
sources | Sites 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. |
questions | Questions. 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. |
products | Products 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_read | Can 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_bing | Google and Bing. The business's Google search figures, Microsoft's AI citing its site, and where it ranks for its questions. |
ads | Ads beside the AI answers. Which advertisers show beside the AI answers to the business's questions, and how often. |
visitors | AI visitors and enquiries. Visits AI assistants sent to the site, where those visitors landed, and enquiries with how they found the business. |
reports | Reports. 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.
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
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
- Looker Studio — the WISE Lens connector, three tables, no code.
- Google Sheets — a script that fills a sheet each day.
- Power BI, Tableau and BigQuery — the daily table into your BI tool or warehouse.
- Webhooks for Zapier, Make and n8n — WISE Lens tells your flow when something happens.
- Your AI assistant — the same data, asked in your own words.
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.
| Day | Kind | What changed |
|---|---|---|
| 10 Nov 2026 | Added | This documentation, and the OpenAPI file at /lens/api/openapi.json. |
| 3 Nov 2026 | Changed | /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 2026 | Added | One 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 2026 | Added | /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 2026 | Added | Read-only API keys, /daily and /answers, as JSON or CSV. |
Questions: support@aiwise.sg