Skip to main content
POST

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
source_url
string<uri> | null

Website or documentation URL to crawl and analyze. Required unless analysis_prompt is provided. Prefer this over prompt-only research: it anchors the analysis to the right company.

Example:

"https://example.com/docs"

​
language
string

Optional output language (ISO 639-1, e.g. en, tr, fr, de). All analysis fields are written in this language. Defaults to the workspace language.

Example:

"fr"

​
analysis_prompt
string | null

Optional extra analysis instruction. Use it to request pricing analysis, documentation summary, or market positioning on top of the standard analysis. The result is returned inside additional_analysis. Can also be used alone (without source_url) for prompt-only research, but results are better when a URL anchors the analysis.

Maximum string length: 4000
Example:

"Summarize the product documentation, pricing pages, and FAQ in detail."

​
search_country
string | null

Optional ISO 3166-1 alpha-2 country code (TR, US, DE, FR, GB...). Localizes the web search to that market. Use when the question or company 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-business analysis. 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 analyze 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 ('mihu.ai'), '-' prefix excludes it ('-wikipedia.org'). Use to keep the analysis pinned to the company's own sites or exclude noisy sources.

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

Analysis depth. When to use each value:

  • fast-search (default): fastest and lowest cost. Small websites, quick summaries. Typical response in seconds.
  • pro-search: balanced speed and quality with better page coverage. Recommended for most business analysis.
  • deep-research: slow, deep crawl and research. Large or complex websites, or extra research via analysis_prompt. Can take minutes.
  • advanced-deep-research: slowest and most exhaustive. Use only when maximum coverage matters more than speed.
Available options:
fast-search,
pro-search,
deep-research,
advanced-deep-research
Example:

"pro-search"

Response

Website analyzed successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Website analyzed successfully"

​
data
object