Ads

Submit a sponsored ad creative

Submit ad creative for review and approval. Accepts multipart/form-data for buyer-uploaded images and ISO-8601 publish_at for scheduled launches. After approval, payment via x402 protocol activates the ad on the platform.

post/api/v1/ad/submit/

Request

  • Base URL: https://api.leviathannews.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.leviathannews.xyz/api/v1/ad/submit/
  • Auth: none declared

Request body

urlstring required

Landing page URL (required)

headlinestring

Ad headline (optional, auto-generated if not provided)

news_idinteger

Existing submission to promote to a sponsored ad (auth required)

mediastring binary

Buyer-uploaded image (multipart file or data: URI). Image only.

media_idinteger

Reuse an existing MediaFile by id

media_urlstring

URL the backend fetches and uploads. Image only.

tagsstring

Comma-separated tags (optional)

tierstring

Pricing tier: standard ($500/1hr), priority ($750/30min), express ($1000/5min)

coupon_codestring

Optional coupon code for discount

publish_atstring date-time

ISO-8601 UTC string. Tz-aware, future, ≤7 days out.

companion_story_urlstring uri

Optional launch or campaign story URL rendered alongside the sponsored destination.

Response

Ad submitted successfully

Changes

No recorded changes to this operation across all 1 revision of this API.