curl · quick start

curl
examples

Quick answer: use these curl requests to test /api/recommend and /api/brief before wiring Wouldliker into an agent or uploader. Responses return official TikTok sound URLs, proof context, captions, and boundary copy.

Open API spec→Back to developers→
01Recommend

Ask for
a sound.

Morning vlog defaults to Vlog unless the clip clearly needs another route.

curl -sX POST https://wouldliker.com/api/recommend \
  -H "content-type: application/json" \
  -d '{"description":"morning routine vlog with oatmeal","platform":"tiktok"}'
02Brief

Generate
the pack.

Use primary_sound.sound_slug from the first response, then request the caption and brief pack.

curl -sX POST https://wouldliker.com/api/brief \
  -H "content-type: application/json" \
  -d '{"sound_slug":"vlog","description":"morning routine vlog with oatmeal","platform":"tiktok","duration_seconds":22}'
03More patterns

Product, AIGC,
football.

The same endpoint handles product reveal, AIGC label guidance, and football routing.

Product

product reveal

Set content_type to product_reveal for ecommerce, UGC, object demo, package reveal, or product showcase.

Product Reveal route
AIGC

label note

Set is_aigc true when the video is AI-generated. The response includes publisher-side label guidance.

No auto-posting
Football

payoff vs reflective

Goal, hype, payoff routes to Hala Madrid. Reflective or elegant club tribute routes to Barcelona.

Deterministic routing

Boundary
language.

Surface the copy_boundary with any proof quote. Wouldliker describes fit and evidence, not guaranteed outcomes.

curl -s https://wouldliker.com/api/momentum
curl -s https://wouldliker.com/api/sounds
curl -s https://wouldliker.com/api/proof?sound=vlog&limit=3