CC Prompt API | Natural-language AI visual prompt search

CC Prompt API

Search the CC Prompt Galaxy library with a natural-language visual description and return matched images, videos and prompts for agents, skills, plugins or apps.

Search endpoint POST https://ccprompt.com/api/v1/search

Natural-language search

Search by subject, style, scene, character or creative use case.

Structured results

Return media URLs, prompt text, detail links, aspect ratio and match score.

Simple parameters

Start with one search endpoint and optionally limit results to images or videos.

API Keys

Create a Key

Docs

API Documentation

Base URL

https://ccprompt.com/api/v1

Authentication

Every request must include your API key in the Authorization header.

POST /search
Authorization: Bearer xixi_live_your_key
Content-Type: application/json

Search endpoint

Item	Description
Method	POST
Path	/search
Content-Type	application/json
Purpose	Search the library with a natural-language description and return matching images, videos and prompts.

Request example

{
  "query": "a robot cafe in a futuristic city, suitable for a short video cover",
  "mediaType": "image",
  "limit": 12
}

Response example

{
  "ok": true,
  "product": "xixi-api",
  "query": "a robot cafe in a futuristic city, suitable for a short video cover",
  "results": [
    {
      "id": "item_xxx",
      "mediaType": "image",
      "title": "Robot cafe in a futuristic city",
      "imageUrl": "https://media.ccprompt.com/...",
      "thumbnailUrl": "https://media.ccprompt.com/...",
      "videoUrl": "",
      "prompt": "...",
      "detailUrl": "https://ccprompt.com/item/item_xxx",
      "score": 0.82
    }
  ]
}

Request fields

Field	Type	Required	Description
query	string	Yes	A natural-language visual description. Include subject, style, scene, character or use case.
mediaType	string	No	Leave empty to search all media. Use image for images only or video for videos only.
limit	number	No	Number of results to return. Default 20, minimum 1, maximum 50.
page	number	No	Page number for pagination. Default 1.

Response fields

Field	Type	Description
ok	boolean	Whether the request succeeded.
product	string	Fixed value: xixi-api.
query	string	The visual description used for this search.
mediaType	string	The media scope used for this search: all, image or video.
page	number	Current page number.
limit	number	Maximum number of results requested.
total	number	Total number of matched results.
totalPages	number	Total number of pages.
results	array	Search result list.

results fields

Field	Type	Description
id	string	Result ID. Useful for deduping or saving a selected item.
mediaType	string	Media type: image or video.
title	string	Title when available. Use prompt as the main text when title is empty.
imageUrl	string	Main image URL for display. Video results usually include a cover image.
thumbnailUrl	string	Thumbnail URL for lists, cards and quick previews.
videoUrl	string	Video URL. Empty for image results.
prompt	string	Prompt text for reference, rewriting or generation workflows.
author	string	Author or source attribution when available.
ratio	string	Aspect ratio, such as 1:1, 16:9 or 9:16.
width	number	Media width. Unknown values are 0.
height	number	Media height. Unknown values are 0.
tags	array	Basic tags such as media type and aspect ratio.
score	number	Semantic match score. Higher usually means closer to the query.
detailUrl	string	CC Prompt Galaxy detail page for the result.

Error format

{
  "ok": false,
  "error": {
    "code": "missing_api_key",
    "message": "Missing Authorization Bearer token."
  }
}

Common error codes

HTTP	code	Description
401	missing_api_key	The request does not include an Authorization Bearer token.
401	invalid_api_key	The key does not exist, has been revoked or is unavailable.
400	missing_query	The query field is missing.
429	rate_limited	Too many requests. Retry later.
503	search_unavailable	Search is temporarily unavailable.

curl example

curl https://ccprompt.com/api/v1/search \
  -H "Authorization: Bearer xixi_live_your_key" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"clean product image for an ecommerce poster\",\"mediaType\":\"image\",\"limit\":8}"

The CC Prompt API is designed for visual inspiration search and prompt reference workflows, including ideation, composition research, style exploration and prompt rewriting.