# Alibaba Cloud CleverSee API

> Alibaba Cloud CleverSee API on Apizie: 4 endpoints (Retrieves the opening remarks and questions for web search Q&A, including statically configured opening…, Performs web-search Q&A (OpenAI-compatible, supports multi-turn context and follow-up recommendations, SSE…, Initiates real-time searches on the Internet and retrieves a structured list of web page results. You can…, version) 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://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-maasaisearchproxy`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/maasaisearchproxy
- Page: https://zieapi.vercel.app/api/cloud/aliyun-maasaisearchproxy
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-maasaisearchproxy/openapi.json

Alibaba Cloud OpenAPI for CleverSee (maasaisearchproxy, version 2026-04-24). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Retrieves the opening remarks and questions for web search Q&A, including statically configured opening…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/opening` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com |
| appId | string | no | The application ID |
| count | integer | no | The number of trending topics to return |
| hotQuestion | string | no | Specifies whether to enable trending topics |
| options | object | no | The extended options |
| userInfo | object | no | The user information |

### Performs web-search Q&A (OpenAI-compatible, supports multi-turn context and follow-up recommendations, SSE…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/qa-chat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com |
| appId | string | no | The application ID |
| deviceId | string | no | The device ID |
| history | array | no | The session history |
| locationInfo | object | no | The location information |
| memory | string | no | The personalized memory (reserved) |
| message | object | no | The user message |
| options | object | no | The business parameters |
| sessionId | string | no | The session ID |
| stream | string | no | Specifies whether to enable streaming |
| userId | string | no | The user ID |

### Initiates real-time searches on the Internet and retrieves a structured list of web page results. You can…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/web-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com |
| endTime | string | no | Specifies the end date for the search results. The API returns results published on or before this date. The format is `YYYY-MM-DD`, such… |
| excludeDomain | array | no | The blacklisted websites. If you specify this parameter, results from the specified domains are excluded. A single request supports up to… |
| includeDomain | array | no | The whitelisted websites. If you specify this parameter, only results from the specified domains are returned. A single request supports… |
| limit | integer | no | The maximum number of results to return. Valid values: 1 to 10. Default value: 10 |
| query | string | no | The search query. Natural language expressions are supported. The recommended maximum length is 100 characters |
| region | string | no | The scope of search sources. Valid values: mainland_china (the Chinese mainland) and global (global). Default value: mainland_china. Note:… |
| searchType | string | no | The search mode. Valid values: pro and lite. Default value: pro. Note: In lite mode, the region, excludeDomain, and includeDomain… |
| startTime | string | no | Specifies the start date for the search results. The API returns results published on or after this date. The format is `YYYY-MM-DD`, such… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/opening" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud CleverSee API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-maasaisearchproxy/opening with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

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

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