# Alibaba Cloud Information Query Service API

> Alibaba Cloud Information Query Service API on Apizie: 15 endpoints (Describes how to invoke the multi-stage streaming API V3 for general search by using the Alibaba Cloud…, Performs a natural language general-purpose query, This topic describes how to invoke the GenericAdvancedSearch operation by using Alibaba Cloud OpenAPI SDKs…, Performs a general search, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-iqs/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-iqs`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/iqs
- Page: https://apizie.tech/api/cloud/aliyun-iqs
- OpenAPI: https://apizie.tech/api/cloud/aliyun-iqs/openapi.json

Alibaba Cloud OpenAPI for Information Query Service (iqs, version 2024-11-11). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Describes how to invoke the multi-stage streaming API V3 for general search by using the Alibaba Cloud…
`GET https://apizie.tech/v1/cloud:aliyun-iqs/ai-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query |
| sessionId | string | no | The query range for the web page publish time |
| timeRange | string | no | The session ID for multi-turn interaction |
| industry | string | no | The industry. If specified, only site content restricted to the specified industry is recalled. Separate multiple industries with commas |
| page | integer | no | The page number. Starts from 1 |

### Performs a natural language general-purpose query
`POST https://apizie.tech/v1/cloud:aliyun-iqs/common-query-by-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | The maximum number of place results to return. Default value: 10 |
| query | string | no | The natural language question used to retrieve nearby places |
| querySceneEnumCode | string | no | The search scenario code. Valid values: hotels (hotel), attractions (attraction), restaurants (restaurant), and entertainment (leisure and… |
| searchModel | string | no | The search result mode. Valid values: single (returns simplified fields) and normal (returns all fields). Default value: normal |

### This topic describes how to invoke the GenericAdvancedSearch operation by using Alibaba Cloud OpenAPI SDKs…
`GET https://apizie.tech/v1/cloud:aliyun-iqs/generic-advanced-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query |
| timeRange | string | no | The relative query range for the webpage publication time. Valid values: OneDay, OneWeek, OneMonth, OneYear, and NoLimit. A value of… |
| sessionId | string | no | The session ID for multi-turn interactions |
| industry | string | no | The industry. If you specify this parameter, only content from websites within the specified industry is recalled. Separate multiple… |

### Performs a general search
`GET https://apizie.tech/v1/cloud:aliyun-iqs/generic-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search keywords |
| timeRange | string | no | The time range |
| sessionId | string | no | The session ID for multi-turn interaction |
| industry | string | no | The industry. If specified, only site content restricted to the specified industry is recalled. Separate multiple industries with commas |
| page | integer | no | The page number. The value starts from 1 |
| returnMainText | string | no | Specifies whether to return the main text of the web page. Default value: true |
| returnMarkdownText | string | no | Specifies whether to return the web page content in Markdown format. Default value: true |
| returnSummary | string | no | Specifies whether to return the enhanced summary. Default value: true |
| enableRerank | string | no | Specifies whether to rerank the retrieval results. Default value: true |
| returnRichMainBody | string | no | Specifies whether to return the full rich text body. Default value: false |
| advancedParams | string | no | The advanced search parameters. You can filter by the start and end dates of the web page publication time. The date format is YYYY-MM-DD.… |

### Queries the daily usage of the information query service API
`GET https://apizie.tech/v1/cloud:aliyun-iqs/get-iqs-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| startDate | string | no | The start date for the usage query, inclusive. The format is YYYYMMDD. The date must be within the last 60 days |
| endDate | string | no | The end date for the usage query, inclusive. The format is YYYYMMDD. The date must be within the last 60 days |
| callerId | string | no | The ID of the RAM user or the API key caller identifier to query |

### Searches for global information by using the Global Edition search
`GET https://apizie.tech/v1/cloud:aliyun-iqs/global-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query |
| timeRange | string | no | The relative time range of the webpage publication time. Specify a value based on the relative time options |
| page | integer | no | The page number. The value starts from 1 |
| pageSize | integer | no | The number of entries per page |

### Queries medical question answering results
`POST https://apizie.tech/v1/cloud:aliyun-iqs/medical-answer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The medical question to be answered |

### Queries the knowledge graph of health information
`POST https://apizie.tech/v1/cloud:aliyun-iqs/medical-knowledge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | no | The medical, drug, disease, or food entity whose properties are to be queried |
| type | string | no | The entity query type. Valid values: finding: disease food: food medicine: medicine If this parameter is not specified, the type is… |

### Performs a multimodal search
`POST https://apizie.tech/v1/cloud:aliyun-iqs/multimodal-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| advancedParams | object | no | The additional query items, such as blocked sites |
| engineType | string | no | The search engine type |
| query | string | no | The query content |

### This topic describes the SearchStream API operation for AI chat with streaming output. Based on retrieval…
`POST https://apizie.tech/v1/cloud:aliyun-iqs/omni-answer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The request parameter |
| sessionId | string | no | The session ID |
| useCot | string | no | Specifies whether to use CoT |
| useModel | string | no | The useModel |

### Quickly fetches HTML and parses static web page content
`POST https://apizie.tech/v1/cloud:aliyun-iqs/read-page-basic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| formats | array | no | The format of the parsing result. rawHtml: the HTML of the target website. html: the page content processed based on readabilityMode.… |
| location | string | no | You do not need to specify this parameter |
| maxAge | integer | no | The maximum cache validity period. Unit: seconds. Default value: 1296000. If the cache duration is less than the value of maxAge, cached… |
| pageTimeout | integer | no | The URL read timeout period. The value of pageTimeout must be less than the value of timeout. Default value: 10000 |
| readability | object | no | The readability configuration for the parsing result |
| timeout | integer | no | The end-to-end processing timeout period. Unit: ms. Valid values: [0, 180000]. Default value: 60000 |
| url | string | yes | The target URL to parse. The value must start with http:// or https:// |

### Reads HTML and parses web page content through a browser sandbox environment. The operation begins parsing…
`POST https://apizie.tech/v1/cloud:aliyun-iqs/read-page-scrape` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| formats | array | no | The format of the parsing result. rawHtml: the HTML of the target site. html: the page content processed based on readabilityMode.… |
| location | string | no | This parameter does not need to be specified |
| maxAge | integer | no | The maximum cache validity period. Unit: seconds. Default value: 1296000. If the cache duration is less than the value of maxAge, cached… |
| pageTimeout | integer | no | The timeout period for waiting for the target site resources to fully load. The value of pageTimeout must be less than the value of… |
| readability | object | no | The readability configuration for the parsing result |
| timeout | integer | no | The end-to-end processing timeout period. Unit: ms. Valid values: [0, 180000]. Default value: 60000 |
| url | string | yes | The target URL to parse. The URL must start with http:// or https:// |

### Scans document images (such as exam papers, books, official documents, certificates, and line drawings) and…
`POST https://apizie.tech/v1/cloud:aliyun-iqs/scan-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| imageBase64 | string | no | The Base64 encoding of the image |
| imageUrl | string | no | The URL of the image |
| scanFileInputConfig | object | no | The scan parameters |

### Provides access to the Tongxiao unified search API, enabling quick and easy integration of web-wide general…
`POST https://apizie.tech/v1/cloud:aliyun-iqs/unified-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| advancedParams | object | no | The advanced search parameters |
| category | string | no | The query category. If specified, only search results from sites of the corresponding category are returned. Separate multiple categories… |
| contents | object | no | The options for controlling the returned content |
| engineType | string | no | The engine type. Default value: Generic. Valid values: Generic and GenericAdvanced. GenericAdvanced is billed separately and returns more… |
| location | string | no | [Deprecated] The location information parameter. Use locationInfo to specify a city or IP address |
| locationInfo | object | no | The location information, used for scenario-based searches such as weather |
| query | string | no | The query content. Length limit: 1 to 100 |
| timeRange | string | no | The content publication time range |

### version
`POST https://apizie.tech/v1/cloud:aliyun-iqs/version` (byok)

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-iqs/ai-search" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Information Query Service API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:aliyun-iqs/ai-search with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Information Query Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Information Query Service itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Information Query Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-iqs.

### What is the status of the Alibaba Cloud Information Query Service API?
Needs your own provider key (bring your own key)