Quick start

Authentication

Unified Search

Lite search

Searches with the lite engine.

curl  -X POST https://cloud-iqs.aliyuncs.com/search/unified \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "Hangzhou food",
  "engineType": "LiteAdvanced",
  "contents": {
    "mainText": true,
    "markdownText":false,
    "summary": false,
    "rerankScore": true
  },
  "advancedParams":{
    "numResults": 5
  }
}'

Standard search

Searches with the standard engine.

curl  -X POST https://cloud-iqs.aliyuncs.com/search/unified \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "Hangzhou food",
  "engineType": "Generic",
  "contents": {
    "mainText": true,
    "markdownText":false,
    "summary": false,
    "rerankScore": false
  },
  "advancedParams":{
    "numResults": 5
  }
}'

Deep search

The deep search engine provides the highest quality results. It supports multiple languages and advanced query understanding. Responses take approximately 10 seconds.

curl  -X POST https://cloud-iqs.aliyuncs.com/search/unified \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "Price comparison between Alibaba Cloud LLMs and other cloud providers in 2026",
  "engineType": "Deep",
  "contents": {
    "mainText": true,
    "markdownText":true,
    "summary": false,
    "rerankScore": false
  },
  "advancedParams":{
    "numResults": 5
  }
}'

Page parsing

Standard parsing

curl --location 'https://cloud-iqs.aliyuncs.com/readpage/basic' \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://help.aliyun.com/document_detail/2837301.html",
    "maxAge": 0
}'

Enhanced parsing

Enhanced parsing uses a browser to dynamically render and read the page. This method returns more complete content but takes longer to respond.

curl --location 'https://cloud-iqs.aliyuncs.com/readpage/scrape' \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://help.aliyun.com/document_detail/2837301.html",
    "maxAge": 0
}'

Multimodal search

curl  -X POST https://cloud-iqs.aliyuncs.com/search/multimodal \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "lion"
}'

Vertical search

Medical Q&A

curl  -X POST https://cloud-iqs.aliyuncs.com/medical/answer \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "What should I do if I have stomach pain?"
}'

Health knowledge graph

curl  -X POST https://cloud-iqs.aliyuncs.com/medical/know \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "Amoxicillin capsules",
  "type": "medicine"
}'