Skip to main content
POST
Publish a post

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
media
object[]
required

The post's media items, in display order. One of: 1-6 images; OR exactly 1 video plus up to 3 images; OR exactly 1 audio file (audio can't mix with other media).

Required array length: 1 - 6 elements
content
string

Optional caption (max 2000 characters).

cover_image
string

Audio posts only — cover art for the track (a public URL, an uploaded-file URL, a data URI, or raw base64; image, max 15 MB). Passed as its own field, never as a media item (audio posts can't mix media).

genre
enum<string>

Audio posts only — one of the site's canonical music genres (exact match). Omit to have the genre classified automatically after publishing.

Available options:
Pop,
Rock,
Hip-Hop & Rap,
R&B & Soul,
Electronic & Dance,
Lo-fi & Chill,
Ambient,
Jazz,
Classical,
Country,
Folk & Acoustic,
Metal,
Blues,
Latin,
K-Pop & J-Pop,
Reggae,
Soundtrack & Cinematic,
Other
lyrics
string

Audio posts only.

song_name
string

Audio posts only — track title.

Response

Post published.

A published post.

credits_charged
integer
Example:

10

id
integer

The post id.

media_type
enum<string>
Available options:
image,
video,
audio
moderation
string

Image/video posts are rated after publish; feed visibility follows the review.

Example:

"pending"

url
string<uri>

Public URL of the post.

Example:

"https://budgetpixel.com/p/12345"