# Alibaba Cloud Marketplace API

> Alibaba Cloud Marketplace API on Apizie: 33 endpoints (Activates an authorization code by calling ActivateLicense, Sets auto-renewal, Confirms that the merchant has received and processed a notification message. After this call, the message…, Calls the CreateOrder operation to create an order. Before calling this operation, make sure that you fully…, …) 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-market/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for Marketplace (market, version 2015-11-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Activates an authorization code by calling ActivateLicense
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/activate-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| LicenseCode | string | yes | The authorization code |
| Identification | string | no | The identity information for activation. Set this parameter to the Alibaba Cloud account ID (aliyunUid) of the user |

### Sets auto-renewal
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/auto-renew-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| Type | string | yes | The operation type. Valid values: open: enables auto-renewal. close: disables auto-renewal. This parameter is required |
| OrderBizId | integer | yes | The Alibaba Cloud Marketplace instance ID. This parameter is required |
| AutoRenewCycle | string | no | The cycle unit. This parameter is required when enabling auto-renewal. Valid values: Day: day. Month: month. Year: year |
| AutoRenewDuration | integer | no | The renewal cycle. This parameter is required when enabling auto-renewal |
| OwnerId | integer | no | The OwnerId |

### Confirms that the merchant has received and processed a notification message. After this call, the message…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/confirm-notification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| NotificationRequestId | string | yes | The notification request ID |

### Calls the CreateOrder operation to create an order. Before calling this operation, make sure that you fully…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/create-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| OrderType | string | yes | The order type. Valid values: INSTANCE_BUY: purchase a product. INSTANCE_RENEW: renew an instance. INSTANCE_UPGRADE: upgrade an instance |
| Commodity | string | yes | The commodity information of the order. You can serialize the corresponding commodity based on the specified OrderType. The CommodityType… |
| OrderSouce | string | no | The order source. This parameter is not in use |
| PaymentType | string | yes | The payment method. Valid values: AUTO: automatic payment from the account balance. HAND: manual payment |
| ClientToken | string | yes | The client token that is used to ensure the idempotence of the request. This parameter value is generated by the client and must be unique… |

### Query cross-account role authorization information, including the authorized user's Alibaba Cloud account…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/cross-account-verify-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| Token | string | no | Token returned upon successful cross-account role authorization |

### Retrieves the API quota data of a user, including the remaining quota, total quota, and usage
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-api-metering` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| productCode | string | no | The commodity code |
| type | integer | no | The type. Valid values: 1: subscription package. 2: resource plan |
| pageNum | integer | yes | The page number |

### Calls DescribeCurrentNodeInfo to retrieve the process information of the current node
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-current-node-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |

### Retrieves a paginated list of promotional products with detailed information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-distribution-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| PageNumber | integer | yes | The current page number |
| PageSize | integer | yes | The number of promotional products per page |
| Filter | string | no | The list of filter conditions (JSON-encoded) |

### Retrieves promotion links for promoted products
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-distribution-products-link` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| Codes | string | yes | The collection of product codes. The collection cannot be empty and can contain up to 50 entries (JSON-encoded) |

### Queries the list of failed subscription notifications. After Alibaba Cloud Marketplace fails to call a…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-failed-notifications` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| PageNumber | integer | yes | The current page number |
| PageSize | integer | yes | The number of instances per page |

### Calls the DescribeInstance operation to query instance information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| OrderType | string | no | The order type. This parameter is deprecated |

### Queries instance information from the service provider side
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-instance-for-isv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |

### Queries the list of services purchased by the user
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| ProductType | string | no | The commodity type. Valid values: APP: application SERVICE: service MIRROR: image DOWNLOAD: download API_SERVICE: API ROS: resource… |
| PageNumber | integer | yes | The number of entries per page |
| PageSize | integer | yes | The page number |
| Codes | string | no | The commodity codes. Separate multiple codes with commas (,) |
| ExceptCodes | string | no | The commodity codes to exclude. This parameter cannot be specified together with the Codes parameter. Separate multiple codes with commas… |

### Queries the invoice information of a supplier store in Alibaba Cloud Marketplace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-invoice-for-isv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| Status | integer | no | The current invoice status. Valid values: 0: processing 1: completed |
| Type | integer | no | The invoice type. If this parameter is left empty, all types are queried by default. Valid values: 2: general digital electronic invoice… |
| InvoiceId | integer | no | The invoice application ID. This corresponds to the Result.Id field in the response of the DescribeInvoiceForIsv operation |
| PageSize | integer | no | The number of instances per page |
| UserId | integer | no | The Alibaba Cloud user ID of the customer |
| CreateTimeEnd | string | no | The end time. The time 23:59:59 is appended to the date by default |
| CreateTimeStart | string | no | The start time. The time 00:00:00 is appended to the date by default |
| PageIndex | integer | no | The page number. Pages start from page 1 |
| MaxResults | integer | no | The maximum number of entries per page for a paged query. Maximum value: 50. Default value: 10. (This parameter is not enabled.) |
| NextToken | string | no | The query token returned by this call. (This parameter is not enabled.) |

### Calls DescribeLicense to query license information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| LicenseCode | string | yes | The activation code |

### Queries the details of a specified order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| OrderId | string | yes | The order ID |

### Queries order details from the service provider side
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-order-for-isv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| OrderId | string | yes | The order ID |

### Calls DescribePrice to query the price information of the corresponding product
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-price` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| OrderType | string | yes | Order type. Valid values: INSTANCE_BUY: Product purchase INSTANCE_RENEW: Instance renewal INSTANCE_UPGRADE: Instance upgrade Note: For… |
| Commodity | string | yes | Serialized commodity information based on the specified OrderType. The CommodityType corresponding to each OrderType is as follows:… |

### Queries the details of a specified product by calling DescribeProduct
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| AliUid | string | no | AliUid |
| Code | string | yes | The commodity code of the product |
| QueryDraft | string | no | Specifies whether to query the product draft. In most cases, you do not need to query the product draft. Product drafts are used to query… |

### Retrieves a list of products that meet the specified conditions along with their details
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| SearchTerm | string | no | The search keyword |
| PageNumber | integer | no | The current page number |
| PageSize | integer | no | The number of products to display per page |
| Filter | string | no | The list of filter conditions (JSON-encoded) |

### Calls DescribeProjectAttachments to retrieve the list of project attachments
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-project-attachments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace business |

### Calls DescribeProjectInfo to query project information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-project-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The business instance ID in Cloud Marketplace |

### Calls DescribeProjectMessages to retrieve the list of project workflow messages
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-project-messages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace business instance |
| PageIndex | integer | no | The page number of the query. Each page contains 20 entries |

### Queries the list of project flow nodes by calling DescribeProjectNodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-project-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |

### Calls DescribeProjectOperateLogs to retrieve the operation logs of a project flow
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/describe-project-operate-logs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |

### Completes the current process by calling FinishCurrentProjectNode
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/finish-current-project-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |
| NodeId | integer | yes | The ID of the process node |
| TemplateForm | string | no | The form content to submit, in JSON format. Example: {"TFD0":"mr.go","TFD1":"1330010xxxx","TFD2":"Chaoyang District, Wangjing Street,… |
| Remark | string | no | The remarks |

### Processes invoice acceptance requests
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/modify-invoice-for-isv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| Type | integer | no | The type of the current invoice. Valid values: 2: digital electronic general invoice. 3: digital electronic special invoice |
| ElectronUrl | string | no | The electronic invoicing URL, used for customers to download the invoice |
| InvoiceId | integer | no | The invoice application ID. This corresponds to the Result.Id field in the response of the DescribeInvoiceForIsv operation |
| OperateType | integer | yes | The operation to perform on the current invoice. Valid values: 0: issue the invoice. 1: reject the invoice |
| CheckNotice | string | no | The remarks on the invoice from the service provider |
| Number | string | no | The invoice number |

### Calls PauseProject to pause a project
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/pause-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |
| NodeId | integer | yes | The ID of the current operation flow node |
| Remark | string | no | The reason for the remark |

### Call PushMeteringData to push metering data
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/push-metering-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| Metering | string | no | The parameters in the example are described as follows: InstanceId: The cloud marketplace instance ID. The parameter type is String.… |

### Pushes usage deduction for a prepaid per-use product to Alibaba Cloud Marketplace on behalf of a service…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/push-times-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The Alibaba Cloud Marketplace instance ID |
| Times | integer | no | The number of uses to deduct. The value must be greater than 0 |
| ClientToken | string | no | The client token that ensures the idempotency of the request. We recommend that you use a UUID. The same `ClientToken` can be submitted… |
| Adjust | string | no | The Adjust |
| AdjustDate | integer | no | The AdjustDate |
| Mark | string | no | The Mark |

### Calls ResumeProject to resume a paused project
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/resume-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |
| NodeId | integer | yes | The ID of the operation flow node |
| Remark | string | no | The reason for the remark |

### Triggers a rejection of the current process node by calling RollbackCurrentProjectNode
`POST https://zieapi.vercel.app/v1/cloud:aliyun-market/rollback-current-project-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID of the Alibaba Cloud Marketplace order |
| NodeId | integer | yes | The ID of the current process node |
| Remark | string | no | The remarks for the rejection reason |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://market.ap-southeast-1.aliyuncs.com |

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

## FAQ

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

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

### Can AI agents use the Alibaba Cloud Marketplace 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-market.

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