---
canonical: https://wouldliker.com/developers/examples/python/
meta-description: One-file Python client for the Wouldliker recommendation API. Requires `requests`. Deterministic.
meta-og:description: One-file Python client for the Wouldliker recommendation API.
meta-og:title: Python example | Wouldliker
meta-og:type: website
meta-og:url: https://wouldliker.com/developers/examples/python/
meta-robots: index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1
meta-theme-color: #0c0c0a
meta-viewport: width=device-width, initial-scale=1.0
title: Python example | Wouldliker
---


★ Python 3.10+★ One file★ Mirrors the Node client★ Deterministic output★ Python 3.10+★ One file★ Mirrors the Node client★ Deterministic output

[![](https://wouldliker.com/assets/brand/wouldliker-tab-icon-192.png?v=20260515-unified-1)Wouldliker](https://wouldliker.com/)

[Sounds](https://wouldliker.com/sounds/)[Breakouts](https://wouldliker.com/breakout-view-examples/)[Matrix](https://wouldliker.com/recommendation-matrix/)[Developers](https://wouldliker.com/developers/)

[Use Vlog](https://www.tiktok.com/music/Vlog-7501680481626785808)

Examples › Python

# Python  *client.*

Quick answer: use the one-file Python 3.10+ client when a scheduler, data job, or AI-video automation needs a sound recommendation, TikTok sound URL, brief, captions, and boundary copy. It implements `describe_to_publishable_pack(description, ...)`.

[Download wouldliker.py→](https://wouldliker.com/developers/examples/python/wouldliker.py)[Back to examples→](https://wouldliker.com/developers/examples/)

01Install

## Save and  *pip install.*

```bash
curl -O https://wouldliker.com/developers/examples/python/wouldliker.py
pip install requests
```

02Use it

## Two calls,  *one helper.*

```python
from wouldliker import describe_to_publishable_pack

pack = describe_to_publishable_pack(
    "Unboxing our new ceramic coffee mug, pour shot, 22 seconds",
    platform="tiktok",
    content_type="product_reveal",
    duration_seconds=22,
)

print(pack["sound"]["tiktok_sound_url"])
print(pack["captions"]["with_hashtags"])
print(pack["copy_boundary"])
```

The helper calls `POST /api/recommend` then `POST /api/brief`, and returns a flat dict with `sound`, `why`, `avoid_if`, `saturation_state`, `proof`, `brief`, `captions`, `hashtags`, `aigc_disclosure`, and `copy_boundary`.

03CLI demo

## Try it from  *the terminal.*

```bash
python wouldliker.py "morning routine vlog with oatmeal"
```

Prints the publishable pack as indented JSON. Useful as a smoke test or piped into another tool.

04What it does not do

## No upload.  *No audio.*

The client returns metadata. Your existing TikTok upload step attaches the sound URL at publish time and files the AIGC label. No audio bytes are downloaded.

WOULDLIKER

★ Sound layer for short-form video

Built to be readable by people, Google, and AI assistants. Public proof. No fake counters. No guaranteed views.

##### Sounds

- [Vlog](https://wouldliker.com/sounds/vlog/)
- [Core](https://wouldliker.com/sounds/core/)
- [Presentation](https://wouldliker.com/sounds/presentation/)
- [Product Reveal](https://wouldliker.com/best-audio-for-product-videos/)

##### Proof & guides

- [Breakouts](https://wouldliker.com/breakout-view-examples/)
- [Proof](https://wouldliker.com/proof-links/)
- [Matrix](https://wouldliker.com/recommendation-matrix/)
- [Football](https://wouldliker.com/best-tiktok-sounds-for-football-edits/)

##### Data

- [Developers](https://wouldliker.com/developers/)
- [Examples](https://wouldliker.com/developers/examples/)
- [llms.txt](https://wouldliker.com/llms.txt)

© 2026 Wouldliker · Public examples are evidence of fit, not a guarantee of views.