Skip to content
aioratings aioratings

Discord & Telegram

Both Discord and Telegram render an image from a URL, so you can embed an aioratings poster anywhere a bot or webhook posts a link/image — for example a “new in library” announcement from Radarr/Sonarr, Overseerr/Jellyseerr, or a custom bot.

aioratings poster URL:

https://api.aioratings.com/{key}/{idType}/poster-default/{id}.jpg

{idType} = imdb / tmdb / tvdb; poster-default = the built-in style or a profile; {id} = tt…, movie-{id} / tv-{id}, or a TVDB id. Full rules in URL shape & idTypes.

Discord

Section titled “Discord”

  • Embeds: set the embed’s image/thumbnail URL to the aioratings poster URL. In an embed JSON payload that is:

    { "image": { "url": "https://api.aioratings.com/KEY/imdb/poster-default/tt0903747.jpg" } }

    (or "thumbnail" for a small poster beside the text).

  • Plain message: posting the bare URL also produces an inline image preview.

Telegram

Section titled “Telegram”
  • sendPhoto: pass the aioratings poster URL as the photo parameter — the Telegram Bot API fetches and posts the image directly.
  • Link preview: posting the URL in a message yields an inline preview where previews are enabled.