Sign in
VCG

Image Search

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.

get/api/vcg/search-image/v1

Query parameters

tokenstring required

Authentication token for this API service.

keywordstring required

Image search keyword, up to 200 characters without control characters.

limitstring

Maximum number of unique images to return, excluding the supplied resource IDs.

startPagestring

First page to search, starting from 1. For continuation, use the next page returned by the previous request.

maxPagesstring

Maximum number of pages to visit in this request. The last requested page must not exceed 10000.

excludeResourceIdsstring[]

Previously collected VCG resource IDs to exclude when continuing a search. Supply comma-separated IDs or repeat this query parameter.

contentFilter'all' | 'selected_500px_no_aigc'

VCG search content filter

Optional brand and AIGC search restriction. Keep this value unchanged across pagination and continuation.

Available Values:

  • all: Keep the default search without additional brand or AIGC filters.
  • selected_500px_no_aigc: Select only 500px Select and 500px Prime, exclude AIGC using the site's filter, and retain best ordering. Do not expand to other brands when results run out.

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
{"stackTrail":"paths:/api/vcg/search-image/v1:get:responses:200:content:application/json:schema:properties:data","oasType":"schema","type":"unknown"}
recordTimestring nullable required
requestIdstring

Changes