curl · quick start

curl
examples

Use these requests to test the live recommendation and brief endpoints. No auth. CORS open. Responses return official TikTok sound URLs, not audio files.

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