vcg.com APIvcg.com ↗
Access VCG stock image metadata, trending search terms, similar images, and brand collections via 7 structured API endpoints covering Visual China Group's library.
curl -X GET 'https://api.parse.bot/scraper/a68c623f-b770-4c73-85fd-62524d4a3cf6/search_images?page=1&keyword=nature' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for creative images by keyword. Returns paginated results with metadata including thumbnail URLs, dimensions, and license type.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| keywordrequired | string | Search keyword (Chinese or English). |
{
"type": "object",
"fields": {
"items": "array of image objects with id, title, thumbnail_url, width, height, contributor, license_type",
"total": "integer total result count"
},
"sample": {
"data": {
"items": [
{
"id": 1571584985,
"title": "自然的律动",
"width": 3953,
"height": 2223,
"asset_id": null,
"contributor": null,
"license_type": "Creative",
"thumbnail_url": "https://vcg02.cfp.cn/creative/vcg/nowater800/new/VCG211571584985.jpg"
}
],
"total": 20000
},
"status": "success"
}
}About the vcg.com API
The VCG API provides 7 endpoints for querying Visual China Group's stock media catalog, returning structured metadata including image dimensions, license types, contributor info, and CDN preview URLs. The search_images endpoint accepts Chinese or English keywords and returns paginated results with thumbnails and license codes. Additional endpoints cover trending search rankings, hot keywords, brand collections, and visually similar image discovery.
Image Search and Detail
The search_images endpoint accepts a keyword parameter (Chinese or English) and an optional page number, returning an array of image objects — each with id, title, thumbnail_url, width, height, contributor, and license_type — plus a total count of matching results. For deeper metadata on any result, get_image_detail takes a numeric image_id and returns the full record: caption, license code (e.g. RF), a keywords array with each keyword's id, cnname, transform, and kind, plus a preview_url for the 800px CDN preview and a full_data object containing all raw metadata fields.
Trending Content and Hot Keywords
The get_hot_rank endpoint surfaces trending search phrases from VCG's creative insight data. Pass a date value of '7' or '30' for the time window, and a type of '1' (images) or '2' (videos). The response includes a data array where each item carries a phrase, searchCount, and rank number, alongside startTime and endTime strings. The get_hot_words endpoint returns a simpler list of system-recommended keywords, each with a keyword string and a link field. An optional limit parameter caps how many items come back.
Brands and Visual Similarity
The get_brands endpoint requires no inputs and returns VCG's available brand collections — each brand object includes id, brandName, assetFamily, licenseType, and pinYin. For reverse-lookup workflows, get_similar_images accepts a similar_id and returns a data array of visually related images, each carrying id, title, res_id, width, height, and url800. If you need only the watermarked preview link for a known image, get_image_thumbnail_url takes an image_id and returns a single thumbnail_url string without the full metadata payload.
- Build a design asset browser that searches VCG by keyword and displays thumbnails, dimensions, and license type from
search_images. - Monitor trending visual themes by pulling weekly or monthly hot search phrases from
get_hot_rankfiltered by image or video type. - Populate autocomplete suggestions in a creative tool using recommended keywords from
get_hot_words. - Enrich an internal DAM (digital asset management) system with full keyword taxonomy and caption data from
get_image_detail. - Implement a 'find similar images' feature by querying
get_similar_imageswith a knownsimilar_idand surfacing related visuals. - Display a brand directory of VCG collections with license and asset family metadata sourced from
get_brands. - Batch-generate preview thumbnails for a content catalog by calling
get_image_thumbnail_urlfor each image ID.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does VCG have an official developer API?+
What does `get_image_detail` return beyond what `search_images` provides?+
search_images returns summary fields — id, title, thumbnail_url, width, height, contributor, and license_type. get_image_detail adds a caption, the full keywords array with per-keyword cnname, transform, and kind fields, a copyright string, an 800px preview_url, and a full_data object containing all remaining raw metadata fields for that image.Can I filter `get_hot_rank` results by editorial versus creative content?+
type parameter distinguishes images ('1') from videos ('2'), and date sets a 7- or 30-day window. Filtering by editorial versus creative sub-type is not currently exposed. The API returns phrase, searchCount, and rank number for each result. You can fork this API on Parse and revise it to add the missing filter endpoint if your use case requires that distinction.Does the API return download URLs or licensing purchase links for images?+
thumbnail_url or preview_url) for 800px watermarked images, along with license_type and license code metadata. Transactional licensing data is not covered. You can fork this API on Parse and revise it to add any endpoint that surfaces licensing workflow data if that becomes available.Are video assets searchable through the same endpoints used for images?+
get_hot_rank accepts type: '2' for video trending data. However, the search_images, get_image_detail, get_similar_images, and get_image_thumbnail_url endpoints are scoped to images only. Video search and detail are not currently covered. You can fork this API on Parse and revise it to add a dedicated video search or detail endpoint.