CRcreatify
html_interactive_ads

GET /api/html_interactive_ads/

Changed on

Retrieve a list of records. Optionally filter by ids (UUIDs) and/or a creation time window [created_after, created_before). The window selects records by when they were created; status and credits_used reflect their current state and can change until the job finishes (failed jobs are refunded and report 0 credits).

Request

  • The document declares no server URL.
  • Auth
    API key in header X-API-ID and API key in header X-API-KEY

Query parameters

created_afterstring date-time

Only return records created at or after this time (inclusive). ISO 8601, e.g. 2026-09-27T00:00:00Z or 2026-09-27T00:00:00+08:00 (URL-encode '+' as %2B). Timestamps without an offset are treated as UTC.

created_beforestring date-time

Only return records created before this time (exclusive). Same format as created_after.

idsstring

Comma-separated list of UUIDs to filter. Maximum 100 entries allowed.

Response

idstring uuid required
created_atstring date-time required
updated_atstring date-time required
linkstring uuid required

The product to advertise: a link from POST /api/links/ (scraped from a URL) or POST /api/links/link_with_params/ (your own title and images). Fix its title, images and logo with PUT /api/links/{id}/ first, because the ads are built from exactly what the link holds.

style_idsstring[] required

The styles to use, one ad per style, from GET /api/html_interactive_ads/styles/.

promotion_infostring nullable

Offer to feature in the ads, e.g. '20% off this week'.

custom_promptstring nullable

Extra direction for the ads, e.g. tone or what to emphasize.

max_size_mbinteger

Largest file size per ad, in MB. Images are compressed to fit; an ad that still does not fit fails and is refunded.

webhook_urlstring uri nullable
status'pending' | 'running' | 'done' | 'failed' required
  • pending - pending
  • running - running
  • done - done
  • failed - failed
failed_reasonstring nullable required
credits_usednumber required

10 credits per ad; failed ads are refunded.

Changes