# Alibaba Cloud Image Search API

> Alibaba Cloud Image Search API on Apizie: 4 endpoints (Queries product information by IDs for online calls to the Taobao Alliance edition, Searches for products by image for online calls to the Taobao Union edition, Searches for products by image URL for online calls to the Taobao Alliance edition, 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-imagesearch/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for Image Search (imagesearch, version 2021-05-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Queries product information by IDs for online calls to the Taobao Alliance edition
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imagesearch/get-product-info-by-ids` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imagesearch.ap-southeast-1.aliyuncs.com |
| ItemIds | string | yes | The product ID string. Separate multiple IDs with commas (,). You can specify up to 40 IDs |
| Pid | string | no | The PID. For more information, see PID… |
| Fields | string | no | The list of fields to return. Separate multiple fields with commas (,). By default, the PicUrl, ReservePrice, Title, Url, and ZkFinalPrice… |

### Searches for products by image for online calls to the Taobao Union edition
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imagesearch/search-by-pic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imagesearch.ap-southeast-1.aliyuncs.com |
| PicContent | string | yes | The image content. The image size cannot exceed 4 MB. Image formats: PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF, and PPM. The transmission wait… |
| CategoryId | integer | no | The image category. For more information, see https://help.aliyun.com/document_detail/179184.html. If you specify a category, the… |
| Pid | string | no | The PID. For more information, see PID… |
| UserType | integer | no | The seller type. 1: Tmall. 0: Taobao |
| Crop | string | no | Specifies whether to perform subject identification. Default value: true. true: The system performs subject identification. This method is… |
| Region | string | no | The subject region of the image. The format is `x1,x2,y1,y2`, where `x1,y1` represents the upper-left corner and `x2,y2` represents the… |
| Start | integer | no | The start position of the returned results. Valid values: 0 to 499. Default value: 0 |
| Num | integer | no | The number of returned results. Valid values: 1 to 20. Default value: 10 |
| Fields | string | no | The list of fields to be returned. Separate multiple fields with commas (,). By default, the PicUrl, ReservePrice, Title, Url, and… |
| RelationId | integer | no | The channel ID. This parameter is used to distinguish channels in Taobao Union |

### Searches for products by image URL for online calls to the Taobao Alliance edition
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imagesearch/search-by-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imagesearch.ap-southeast-1.aliyuncs.com |
| PicUrl | string | yes | The image URL. The URL must start with HTTP or HTTPS |
| CategoryId | integer | no | The image category. For more information, see https://help.aliyun.com/document_detail/179184.html. If you specify a category, the… |
| Pid | string | no | The PID. For more information, see PID… |
| UserType | integer | no | The seller type. Valid values: 1: Tmall. 0: Taobao |
| Crop | string | no | Specifies whether to perform subject identification. Default value: true. true: The system performs subject identification. We recommend… |
| Region | string | no | The subject region of the image. The format is x1,x2,y1,y2, where x1,y1 represents the upper-left corner and x2,y2 represents the… |
| Start | integer | no | The start position of the returned results. Valid values: 0 to 499. Default value: 0 |
| Num | integer | no | The number of returned results. Valid values: 1 to 20. Default value: 10 |
| Fields | string | no | The list of fields to be returned. Separate multiple fields with commas (,). By default, the PicUrl, ReservePrice, Title, Url, and… |
| RelationId | integer | no | The channel ID. This parameter is used to distinguish channels in Taobao Alliance |

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

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-imagesearch/get-product-info-by-ids" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Image Search API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-imagesearch/get-product-info-by-ids with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud Image Search 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-imagesearch.

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