---
title: "Image Search"
method: GET
path: "/api/vcg/search-image/v1"
tags: ["VCG"]
---

# Image Search

`GET /api/vcg/search-image/v1`

Searches VCG images by keyword with a requested image count, page controls, exclusions for previously collected resource IDs, and an optional 500px Select/Prime filter excluding AIGC. Use the same content filter when continuing an interrupted search.

## Query parameters

- `token` string, required
- `keyword` string, required
- `limit` string
- `startPage` string
- `maxPages` string
- `excludeResourceIds` string[]
- `contentFilter` 'all' | 'selected_500px_no_aigc' — VCG search content filter

## Response `200`

OK

- object
  - `code` 0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602, required
  - `message` string, nullable, required
  - `data` unknown, required
  - `recordTime` string, nullable, required
  - `requestId` string

## Other responses

- `400` — Invalid request parameters or body
- `401` — Invalid or inactive access token
- `403` — Permission denied
- `429` — Request rate or daily quota limit exceeded
- `500` — Internal server error
- `503` — Service temporarily unavailable

## Changes

- **2026-09-17** `6647cbf7d218` — 1 info
  - added the new optional `query` request parameter `contentFilter`
- **2026-09-16** `11fffe23bdec` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/justoneapi/apis/openapi-definition/changes/api/vcg/search-image/v1/get.md)

---

[API](https://skmtc.dev/justoneapi/apis/openapi-definition.md) · [All operations](https://skmtc.dev/justoneapi/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc.dev/justoneapi/apis/openapi-definition/revisions/a57e992ef183?raw)