Skip to main content
POST
/
api
/
v1
/
agents
/
analyze-website
curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/agents/analyze-website \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_url": "https://mihu.ai",
  "language": "en"
}
'
{
  "success": true,
  "message": "Website analyzed successfully",
  "data": {
    "company_name": "Mihu AI",
    "purpose": "AI-powered contact center platform handling calls, messaging, and CRM updates.",
    "industry": [
      "Artificial Intelligence"
    ],
    "services": "AI voice agents, WhatsApp automation, appointment booking, call routing",
    "audience": "Contact centers, healthcare, automotive, high-call-volume businesses",
    "customer_questions": "Pricing, integrations, setup time, supported languages",
    "faq": "How fast can I go live? Which CRMs are supported?",
    "solutions": "24/7 call answering, lead qualification, QA scoring",
    "current_possible_doing_by_human": "Call answering, appointment scheduling, data entry",
    "possibles_to_automate_with_ai_agent": [
      "Instant 24/7 call answering"
    ],
    "additional_analysis": {},
    "contact_information": "sales@example.com",
    "language": "en",
    "_citations": [
      "https://mihu.ai"
    ]
  }
}

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