Skip to main content
POST
/
api
/
v1
/
agentic-search
curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/agentic-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "What does example.com do? Answer in one short paragraph.",
  "search_preset": "fast-search"
}
'
{
  "success": true,
  "message": "Search completed successfully",
  "data": {
    "answer": "Example Corp is a home services company operating in Istanbul. Customers most often ask about pricing, availability, and same-day appointments...",
    "citations": [
      "https://example.com"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Body

application/json
​
query
string
required

The research question or analysis instruction. Be specific: name the company, market, and what to compare — specific questions return far better answers than broad ones.

Maximum string length: 4000
Example:

"What are the most common customer questions when booking a dental appointment?"

​
language
string

Optional output language (ISO 639-1, e.g. en, tr, fr, de). The answer is written in this language. Defaults to the workspace language.

Example:

"tr"

​
search_country
string | null

Optional ISO 3166-1 alpha-2 country code (TR, US, DE, FR, GB...). Localizes search results to that market. Use when the question is market-specific.

Example:

"TR"

​
search_region
string | null

Optional state, province, or administrative region for finer localization. Use together with search_country.

Example:

"Istanbul"

​
search_city
string | null

Optional city for local questions (e.g. local vendors, local services). Use together with search_country.

Example:

"Istanbul"

​
search_latitude
number<float> | null

Optional latitude for precise location-based search. Use with search_longitude and search_country.

Example:

41.0082

​
search_longitude
number<float> | null

Optional longitude for precise location-based search. Use with search_latitude and search_country.

Example:

28.9784

​
search_language_filter
string[] | null

Optional ISO 639-1 language codes. Restricts which source languages are searched — e.g. ['tr'] to research only Turkish sources. Independent from the output language.

Maximum array length: 10
​
search_domain_filter
string[] | null

Optional domain allow/deny list, maximum 20 entries. Plain domain includes it ('example.com'), '-' prefix excludes it ('-wikipedia.org'). Use to pin research to official sites or to exclude noisy sources.

Maximum array length: 20
​
search_preset
enum<string>
default:fast-search

Search depth. When to use each value:

  • fast-search (default): fastest and lowest cost. Simple questions, short factual answers, quick summaries. Typical response in seconds.
  • pro-search: balanced speed and quality with better source coverage. Recommended default for business research and most production use.
  • deep-research: slow, multi-source research. Complex questions, market overviews, detailed comparisons. Can take minutes.
  • advanced-deep-research: slowest and most exhaustive. In-depth reports where completeness matters more than speed.
Available options:
fast-search,
pro-search,
deep-research,
advanced-deep-research
Example:

"pro-search"

Response

Search completed successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Search completed successfully"

​
data
object