Answer

POST

https://api.staan.ai/v2

/answer

Answer › Headers

Authorization

string · required

Default: Bearer YOUR_API_KEY

Answer › Request Body

AnswerRequest

query

string · required

User question

Example: Macbook néo

filter

string

Canonical domain filter for search (without www or URL scheme) — if omitted, no site: constraint is applied

Example: frandroid.com

stream

boolean

Stream the response as SSE

Default: false

AnswerHistoryMessage[] · maxItems: 20

Conversation history — strictly alternating user/assistant pairs (user first), max 10 pairs (20 messages)

mode

string · enum

Response length mode

Enum values:

short

long

Default: short

language

string · enum

Answer language

Enum values:

Default: fr

markdown

boolean

Whether the response should use Markdown formatting

Default: false

related_queries

boolean

Whether to generate up to 5 related search queries (search-engine style)

Default: false

query_rewrite

boolean

Rewrite search query before web search

Default: true

AnswerSourceItem[] · maxItems: 10

Caller-supplied sources — bypasses Bloom search when provided. query_rewrite is ignored when this field is set.

sources_mode

string · enum

'search' fetches+reranks sources like web results (default); 'context' injects full content directly without reranking

Enum values:

context

Default: search

Answer › Responses

Answer V2 generated successfully

AnswerResult

request_id

string · required

Request / trace identifier.

answer

string · required

AnswerCitationRef[] · required

related_queries

string[] · required

AnswerSource[] · required

AnswerStepUsage[] · required

POST/answer

curl https://api.staan.ai/v2/answer \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "query": "What are the best smartphones in 2024?",
  "mode": "short",
  "language": "fr"
}'

Example Request Body

{
  "query": "What are the best smartphones in 2024?",
  "mode": "short",
  "language": "fr"
}

json

application/json

Example Responses

{
  "request_id": "request_id",
  "answer": "answer",
  "citations": [
    {
      "position": 0,
      "source_id": "source_id"
    }
  ],
  "related_queries": [
    "string"
  ],
  "sources": [
    {
      "id": "id",
      "url": "https://www.example.com/path/to/resource",
      "title": "title"
    }
  ],
  "usages": [
    {
      "step": "answer",
      "input_tokens": 0,
      "output_tokens": 0
    }
  ]
}

json

Answer

POST

https://api.staan.ai/v2

/answer

Answer › Headers

Authorization

string · required

Default: Bearer YOUR_API_KEY

Answer › Request Body

AnswerRequest

query

string · required

User question

Example: Macbook néo

filter

string

Canonical domain filter for search (without www or URL scheme) — if omitted, no site: constraint is applied

Example: frandroid.com

stream

boolean

Stream the response as SSE

Default: false

AnswerHistoryMessage[] · maxItems: 20

Conversation history — strictly alternating user/assistant pairs (user first), max 10 pairs (20 messages)

mode

string · enum

Response length mode

Enum values:

short

long

Default: short

language

string · enum

Answer language

Enum values:

Default: fr

markdown

boolean

Whether the response should use Markdown formatting

Default: false

related_queries

boolean

Whether to generate up to 5 related search queries (search-engine style)

Default: false

query_rewrite

boolean

Rewrite search query before web search

Default: true

AnswerSourceItem[] · maxItems: 10

Caller-supplied sources — bypasses Bloom search when provided. query_rewrite is ignored when this field is set.

sources_mode

string · enum

'search' fetches+reranks sources like web results (default); 'context' injects full content directly without reranking

Enum values:

context

Default: search

Answer › Responses

Answer V2 generated successfully

AnswerResult

request_id

string · required

Request / trace identifier.

answer

string · required

AnswerCitationRef[] · required

related_queries

string[] · required

AnswerSource[] · required

AnswerStepUsage[] · required