> ## Documentation Index
> Fetch the complete documentation index at: https://hireobi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How Obi writes buyer questions

> What a buyer question is, how Obi writes it from your evidence, and how you review the set before any scan.

A buyer question is the prompt a real buyer types into ChatGPT, Claude, Gemini or Perplexity while deciding what to buy. A scan measures what the engines answer to it, so a generic question measures a market nobody is in.

## Choosing what to measure

After you confirm your business, Obi shows the measurement markets it supports and the buyer audiences from your confirmed review. You choose **one market** and **one primary audience**. A suggested market is guidance; Obi does not pick one for you.

Changing the language of the conversation does not change the market, audience or question set.

## How Obi writes them

Obi reads every fact it saved about your business before writing: offer, prices, use cases, integrations, objections, proof, competitor positioning and the words buyers use on the pages it read. Then each question:

* is written from the selected buyer's seat: their job, the situation that starts the search, the constraint they state (budget, country, stack, team size, compliance);
* reads like a chat prompt: first person, one ask, 8 to 30 words, a concrete situation, no adjectives copied from marketing pages;
* cites the facts it came from.

Across the set, the questions cover the stages of buyer awareness, from someone who does not know the category yet to someone choosing between named options, and six intents: category discovery, use case, feature, comparison, alternatives and trust.

Most questions do not name your company or a rival. Obi's servers refuse a set where too many questions are branded; comparison and alternatives questions use that allowance.

| A search query | A buyer prompt |
| - | - |
| Best AI gateway? | We are three developers shipping a Django app and need one API for several model providers with EU hosting, what should we use? |

## Reviewing the set

Obi shows you five representative questions with the fact each came from, then the full set when you ask. You judge the voice; correct any question in plain language and Obi saves your wording as a new version of the set. Earlier versions stay distinct, and a scan always records which version it measured.

If you later correct your business in a way that changes the buyer or market, Obi redrafts against the new review. Questions based on the earlier version stay visibly marked as such until their replacement is accepted.

> [card] [Next: scans and engines](https://hireobi.com/docs/how-it-works/scans.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.