The Ask API

Ask geoSurge.
From any agent.

Ask a question here, or call GET /ask from an AI agent or application. Send a free-form question as q; optionally add a local page path identifying where the question came from. The API returns JSON with an answer.

AvailableAsk is accepting questions
API / GET REQUESTASK

THE ENDPOINT

GEThttps://geosurge.org/ask

Pass a URL-encoded q parameter with your question, and optionally page with a local path. A successful response returns JSON with an answer string.

REQUEST EXAMPLE01 / CURL
curl --fail-with-body --silent --show-error --connect-timeout 5 --max-time 75 -G 'https://geosurge.org/ask' \
  --data-urlencode 'q=What does geoSurge measure?' \
  --data-urlencode 'page=/'

-G sends GET; --data-urlencode safely adds both values. Connection setup is capped at 5 seconds and the full request at 75 seconds. --silent hides progress, --show-error reports failures, and --fail-with-body keeps HTTP error details visible.

Read the machine guide

Public reference geoSurge field note 001

A clearer record
for AI.

What a model says about a brand depends on what it remembers and what it finds. Explore geoSurge here, then use the Ask API for specific questions.

HOW AN AI ANSWER FORMS 01 / 03
QUESTIONWhich brand should I choose?
◉PATH AModel memoryWhat it already knows
↗PATH BLive retrievalWhat it finds now
↳THE RESULTAn answer that shapes a decision.
01 / THE COMPANYAn answer-first view
of brand visibility.

About geoSurge

See how your brand appears inside the answer.

geoSurge helps brands and agencies measure, understand and improve how they are represented in AI systems such as ChatGPT, Claude and Gemini. It tracks the questions buyers ask, where a brand appears, which competitors appear beside it, and which sources a model cites.

Its product separates two signals: what a model can recall from training, and what it retrieves from the live web. Reading those signals together helps teams decide whether to improve their content, their representation in model memory, or both.

Ask a follow-up question

The framework

One answer. Two kinds
of visibility.

AI systems can respond from what they already know or consult current webpages. geoSurge measures these routes separately because each points to a different kind of work.

01

MODEL MEMORY

Parametric visibility

What a model recalls about a brand without searching. This shows whether the brand is already part of the model’s internal picture of a category.

Ask about model memory
02

LIVE SOURCES

Dynamic visibility

What appears when a model searches, reads and cites current web pages. This shows how well a brand’s content is being found and used right now.

Ask about live retrieval

Ask geoSurge how these two forms of visibility are measured and where they lead to different actions.

The product

From observation
to action.

geoSurge provides measurement tools and workflows for both layers of visibility.

01 / TRACK

Track the answers

Run buyer questions across AI models and inspect brand visibility, competitors, citations and the searches that led to an answer.

Ask about Tracking ↗
02 / DISCOVER

Inspect memory

Study what models recall about a brand before live web retrieval, including how it sits alongside category alternatives.

Ask about Discover ↗
03 / IMPROVE

Shape the corpus

Structure brand information for the sources and training moments that influence how AI systems describe it.

Ask about corpus engineering ↗

Accessible measurement. geoSurge provides free prompt tracking through a macOS app connected to a customer's ChatGPT, Claude or Gemini subscription. Its enterprise work includes corpus engineering.

Ask for details ↗

Keep exploring

Ask the next
question.

Each example calls this site's Ask API. Replace the question with what you need to know.