rizamodocs
Accounts

Search music for an account

GET
/accounts/{id}/music

Tracks the account may put on a post, from its network's library. TikTok: its Commercial Music Library's trending list (up to 100), filtered by genre, country and period; there is no search. The same filters answer the same list for 30 minutes, and searches beyond Rizamo's limits on TikTok answer 429 with when to try again. Instagram (accounts connected through Facebook Login): a search with q, or what is trending without it, up to 25, music or original sounds. Facebook adds no music through its API. A filter of the other network is refused. Attach a track's id in the target's music option.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the web app, under Developers. It starts with rz_live_.

Path Parameters

id*string

The account (acc_) the post goes to: a TikTok account, or an Instagram account connected through Facebook Login.

Lengthlength <= 100

Query Parameters

q?string

Instagram: words to search for. Left out, Instagram's trending tracks. TikTok has no search.

Length1 <= length <= 100
type?string

Instagram: music (the default) or original sounds from other reels.

Value in"music""original"
genre?string

TikTok: one of TikTok's genres. Default ALL.

Value in"ALL""ROCK""POP""LATIN""METAL""ELECTRONIC""HIP_HOP/RAP""ALTERNATIVE/INDIE""FOLK""R&B/SOUL""COUNTRY""CLASSICAL""JAZZ""REGGAE""CHILDHOOD""BLUES""EASY_LISTENING""NEW_AGE""WORLD_MUSIC""EXPERIMENTAL""DEVOTIONAL""CHINESE_TRADITION""8_BIT""A_CAPPELLA""AFRO-POP""ALTERNATIVE_HIP_HOP""ALTERNATIVE_ROCK""AMBIENT""ARABIC_POP""BASS_HOUSE""BGM""BOOMBAP""BOSSA_NOVA""BRAZILIAN_FUNK_STYLE""BUDDHIST_MUSIC""CANTOPOP""CELTIC_POP""CHAMBER_MUSIC""CHILL_BEATS""CHILLOUT""CHINESE_FOLK""CHINESE_OPERA""CHINESE_POP""CHINESE_STYLE""CHINOISERIE_ELECTRONIC""CHINOISERIE_RAP""CHRISTIAN_MUSIC""CONTEMPORARY_R&B""COUNTRY_POP""DANCE_POP""DISCO""DJ""DRUM&BASS""DUBSTEP""EDM""EDM_TRAP""ELECTRO_POP""EPIC""FOLK_POP""FUNK""FUTURE_BASS""GOSPEL""GUFENG_MUSIC""HARD_ROCK""HIP_HOUSE""HOLIDAY_MUSIC""HOUSE""INDIAN_POP""INDIE_FOLK""INDIE_POP""INDIE_ROCK""INSTRUMENTAL_HIP_HOP""INSTRUMENTAL_ROCK""IRISH_FOLK""J_ROCK""JAPANESE_TRADITIONAL_MUSIC""JAZZ_FUSION""JAZZ_HIP_HOP""JAZZ_POP""J-POP""K-POP""LATIN_POP""LO-FI""MC""NOISE""OLD_SCHOOL""OTHERS""POP_RAP""POP_ROCK""POP_SOUL""PSYCHEDELIC_ROCK""PUNK""R&B_RAP""REGGAETON""RUSSIAN_POP""SERTANEJO""SON_CUBANO""SOUL""SOUNDTRACK""SYMPHONY""SYNTH_POP""TANGO""TECHNO""TEEN_POP""TRADITIONAL_CHINESE_FOLK""TRANCE""TRAP_RAP""TRIP_HOP""TROPICAL_HOUSE""TURKISH_POP"
country?string

TikTok: where the tracks are trending, as a two-letter code such as PT. Default US (TikTok's).

Match^[A-Za-z]{2}$
period?string

TikTok: trending over the last day, week (the default), 30 or 90 days.

Value in"1d""7d""30d""90d"

Response Body

OK

application/json
  1. response
items*array<>
Example Request
curl -X GET 'https://api.rizamo.com/v1/accounts/acc_01m43kdrr0ebxa6wpz9f3zmaqa/music?country=PT&period=7d'
Example Response
{  "items": [    {      "id": "7607562034594449425",      "title": "Self Aware",      "artist": "Temper City",      "durationMs": 29000,      "previewUrl": "https://sf16-ies-music-sg.tiktokcdn.com/obj/trending-7600130441848687390.mp3",      "coverUrl": null,      "kind": "music",      "expiresAt": null    }  ]}

Get a TikTok account's posting settings GET

What TikTok's posting screen needs, read from TikTok now: the creator's name and picture, who can see a photo post, whether the account turned comments, Duet or Stitch off, and the longest video it may post. TikTok asks apps to show the creator's name and these choices before every post.

Preview removing an account GET

What removing the account would do to the posts that use it, counted now, with nothing changed: show it to the person before they confirm. `Remove an account` answers the same counts once it is done.