Search Assets

Search Prism community assets and your own generation history by prompt text, media type, source, limit, and pagination offset.

GET /api/assets/search

Searches visible assets by prompt text. Results can include published community assets and assets from the API key owner’s generation history.

Query parameters

Parameter	Type	Default	Description
q	string	Required	Search text matched against prompts (minimum 2 characters)
type	"all", "image", or "video"	"all"	Asset type filter
source	"all", "community", or "history"	"all"	Search public community posts, your own history, or both
limit	integer	24	Number of assets to return (max 60)
offset	integer	0	Pagination offset

Request

curl "https://www.prismvideos.com/api/assets/search?q=product&type=video&source=all&limit=10" \
  -H "Authorization: Bearer prism_sk_your_key_here"

Response

{
  "data": [
    {
      "id": "post_abc123",
      "asset_id": "asset_abc123",
      "asset_s3_key": "generations/user/video.mp4",
      "asset_url": "https://...",
      "asset_type": "video",
      "prompt": "A cinematic product demo...",
      "model_name": "veo-3.1",
      "published_at": 1773361092291,
      "created_at": null,
      "metadata": {},
      "source": "community"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10,
    "has_more": false
  }
}

Response fields

Asset object

Field	Type	Description
id	string	Community post ID or generation ID, depending on source
asset_id	string	Asset record ID
asset_s3_key	string	S3 object key for the asset
asset_url	string or null	Stored asset URL when available
asset_type	"image" or "video"	Asset media type
prompt	string	Prompt text matched by the search
model_name	string or null	Model name when available
published_at	number or null	Unix timestamp in milliseconds for community posts
created_at	number or null	Unix timestamp in milliseconds for history assets
metadata	object or null	Asset or generation metadata
source	"community" or "history"	Where the result came from

Pagination object

Field	Type	Description
offset	number	Current offset
limit	number	Requested limit
has_more	boolean	Whether more results exist beyond this page

Errors

Status	Error	When
400	validation_error	Missing/short q, invalid type, or invalid source
401	unauthorized	Missing or invalid API key
500	server_error	Unexpected server error while searching assets

See Errors for the full error reference.