Build with the Maystro AI API

Answers and sources,ready for your app.

Send a question to the search API and receive an AI-generated answer with citations in a structured JSON response.

REST · JSONOptional account token

Example request

POST /search

curl -X POST "$API_BASE_URL/search" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do solar panels work?",
    "language": "en",
    "mode": "search"
  }'

Designed for integration

A simple interface for useful answers

Use the same search capabilities in your own workflows, with source links and streaming support.

Ask with one request

Send a query with a language and search mode to get a clear, structured answer.

Keep sources attached

Search responses include citation details such as the source title, URL, excerpt, and source type.

Stream as it generates

Use POST /search/stream to receive newline-delimited JSON events as the answer is generated.

Example response

application/json

Illustrative response; the selected model and citation values depend on your request.

{
  "query": "How do solar panels work?",
  "answer": "Solar panels convert sunlight into electricity...",
  "model": "selected-by-your-plan",
  "mode": "search",
  "citations": [
    {
      "id": 1,
      "title": "Solar energy basics",
      "url": "https://example.com/solar",
      "snippet": "Photovoltaic cells convert light into...",
      "engine": "web"
    }
  ]
}

Request parameters

Send a JSON body to POST /search. Query is required; the other fields are optional.

query: Required. Your question, at least 2 characters.
language: Optional. Answer language: en or tr. Defaults to en.
mode: Optional. auto, search, or chat. Defaults to auto.

Authentication and usage

The search endpoint accepts requests without a token under guest-plan limits. Include a valid app account access token as a Bearer token to use the signed-in account's plan and quota. Never expose account tokens in public client code.

Rate limits and plan quotas

Search and streaming requests are rate-limited to 20 per minute. Search usage also counts against the applicable guest or account plan quota.

API base URL

The API host depends on your Maystro AI deployment. Set API_BASE_URL to the backend origin provided by your deployment.

Ready to try a search?

Explore Maystro AI in the web app, then connect your workflow to the API.

Open Maystro AI