API

Access WoopicX image search via API. All endpoints require an API key.

API Keys

Endpoints

All endpoints require X-API-Key header

POST/v1/search

GET/v1/asset/{uid}

GET/v1/collections

GET/v1/key-info

Search

POST https://api.woopicx.com/v1/search

Parameters

querySearch query (optional if collection specified)

limitResults per page (default: 50, max: 100)

offsetPagination offset (default: 0)

collectionFilter by collection

media_typeFilter by type: image, video, 3d

sortSort order: relevance, newest, rating

Response

Returns previews only. Use /v1/asset/{uid} to download.

{
  "results": [{
    "uid": "abc-123",
    "title": "Asset title",
    "thumb_url": ["https://..."],
    "preview_url": "https://...",
    "is_free": true,
    "media_type": "png",
    "collection": ["basic3d"]
  }],
  "total_found": 100
}

Examples

Search videos:

{"collection": "base-video", "limit": 10}

Search 3D assets:

{"collection": "basic3d", "limit": 10}

Search with query:

{"query": "office", "collection": "base-video", "limit": 10}

Asset

GET https://api.woopicx.com/v1/asset/{uid}

Returns asset metadata with main file URL. For paid assets, main_url is a signed URL valid for 7 days.

Parameters

formatFile format: png, svg, mp4 (optional, auto-detected)

Response

{
  "uid": "abc-123",
  "title": "Asset title",
  "media_type": "png",
  "is_free": true,
  "main_url": "https://images.woopicx.com/...",
  "preview_url": "https://...",
  "main_width": 1920,
  "main_height": 1080,
  "format": "png"
}

Premium Assets

Assets with is_free: false require active subscription. Returns 403 if no subscription.

Collections

GET https://api.woopicx.com/v1/collections

Returns list of available collections with asset counts. Requires API key.

Available Collections

baseimageGeneral images

base-videovideoStock videos

basic3d3d3D renders and objects

basic-greenimageGreen screen backgrounds

real-estateimageReal estate photos

glass-iconsimageGlass-style icons

abyssimageDark abstract visuals

lets-presentimagePresentation graphics

story-imageimageSocial media stories

tattooimageTattoo designs

mobile-phone-mockupimagePhone mockups

Rate Limits

Rate limit is set per API key (default: 100 requests/min). Need more? Contact us