---
title: "Search images"
method: GET
path: "/images/search"
---

# Search images

`GET /images/search`

## Query parameters

- `term` string, required
- `registry` string

## Response `200`

No error

- SearchResultItem[]
  - `description` string — description just shows the description of this image
  - `is_official` boolean — is_official shows if this image is marked official.
  - `is_automated` boolean — is_automated means whether this image is automated.
  - `name` string — name represents the name of this image
  - `star_count` integer — star_count refers to the star count of this image.

## Other responses

- `500` — An unexpected server error occurred.

## Changes

> 50 revisions in range; 2 could not be searched.

- **2019-05-29** `3d78e99aa2b8` — 1 breaking, 1 info
  - added the new required `query` request parameter `term`
  - added the new optional `query` request parameter `registry`
- **2018-08-03** `5ae9c809fadb` — 2 warning
  - deleted the `query` request parameter `registry`
  - deleted the `query` request parameter `term`

[Change history](https://skmtc.dev/aliyun/apis/pouch-engine-api/changes/images/search/get.md)

---

[API](https://skmtc.dev/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.dev/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/revisions/36d75b2825fc/schema)