Social Lookups & Feeds

#Overview

greed integrates with popular social platforms to provide two distinct features:

• Feed Notifications: Automatically post updates to Discord when creators go live or publish something new — TikTok, Twitch, YouTube, Instagram, X, Pinterest, SoundCloud and Kick.
• Profile Lookups: Query user profiles, stats, and game information across multiple platforms (Roblox, Valorant, Spotify, Minecraft, GitHub, and more).

#Feed Notifications

Set up live feed notifications to post creator updates directly to a channel. Up to 10 feeds per guild per platform.

#TikTok Feeds

Post new uploads from TikTok creators in a channel.

,tiktok add (username) (channel)

#Instagram Feeds

Post an account's new uploads in a channel, and optionally announce when they go live.

,instagram add (username) (channel)

Feed variables:

#Twitch Alerts

Announce when a Twitch channel goes live.

,twitch add (login) (channel)

#YouTube Feeds

Post new uploads and live streams from YouTube channels.

,youtube add (channel_name) (channel)

#X Feeds

Post an account's new posts from X (formerly Twitter) in a channel.

,x add (handle) (channel)

#Pinterest Feeds

Post an account's new pins in a channel, either from every board or from one specific board.

,pinterest add (username) (channel) [board]

#SoundCloud Feeds

Post an artist's new tracks in a channel.

,soundcloud add (artist) (channel)

#Kick Alerts

Announce when a Kick channel goes live.

,kicklive add (channel_name) (channel)

#Custom Feed Messages

Every social feed supports fully custom notification messages. Use the ,<platform> message command to set a template that renders when new content is posted. Templates use greed's scripting language to combine text, embeds, and interactive components — see Embed Scripting and Components for syntax.

#Fallback Behavior

If your custom template renders to nothing (empty text content, no embeds, no components), greed falls back to the built-in default layout for that platform. This lets you use conditionals and optional content without losing notifications.

#Twitch Custom Messages

Twitch live alerts use 8 available variables to build rich notifications. The built-in layout shows the streamer's name, stream title, thumbnail, viewer count, category, and a direct link to the stream.

Twitch Variables

Twitch Examples

{twitch.creator.name} is live on Twitch playing {twitch.category}!
{twitch.title}
{twitch.url}

#YouTube Custom Messages

YouTube feeds support two distinct events: uploads (new videos or Shorts) and live streams. Each has a different set of available variables. The built-in layout shows the channel name, video title, thumbnail, publication time, and a link.

YouTube Variables by Event Type

Upload Variables (triggered when a new video or Short is posted):

Live Stream Variables (triggered when the channel goes live):

YouTube Examples

New video from {youtube.creator}!
{youtube.title}
{youtube.url}

#TikTok Custom Messages

TikTok feeds post when creators upload new videos or photos. The built-in layout shows the creator's name, post caption, engagement stats (likes, comments, plays), media thumbnails, and a direct link.

TikTok Variables

TikTok Examples

{tiktok.creator.name} just posted!
{tiktok.caption}
{tiktok.url}

#X Custom Messages

X feeds post original posts, self-replies (threads) and — unless you turn them off — reposts. {x.type} tells you which one you are rendering, so a single template can handle all three.

X Variables

X Examples

{x.creator} posted on X
{x.text}
{x.url}

#Pinterest Custom Messages

Pinterest feeds post one message per new pin, whether the feed follows a single board or the whole account.

Pinterest Variables

Pinterest Examples

{pinterest.creator} pinned something new
{pinterest.title}
{pinterest.url}

#SoundCloud Custom Messages

SoundCloud feeds post one message per new track, with the artwork, duration and play count available to your template.

SoundCloud Variables

SoundCloud Examples

{soundcloud.creator} posted a new track — {soundcloud.title} ({soundcloud.duration})
{soundcloud.url}

#Kick Custom Messages

Kick alerts fire once per broadcast, with the same shape as Twitch alerts.

Kick Variables

Kick Examples

{kick.creator.name} is live on Kick playing {kick.category}!
{kick.title}
{kick.url}

#Role Mentions in Feed Messages

When you set a role ping with ,<platform> ping (target) (role), greed prepends the role mention to your rendered message. The mention is added as <@&role_id> before your template's output, and configured for proper Discord allowedMentions.

If your custom template renders empty, the role mention still appears before the fallback default layout.

Example: If you set a custom Twitch message and assign a role:

,twitch message mystreamer {twitch.creator.name} is live!
,twitch ping mystreamer @StreamAlerts

The posted message will be: <@&123456789012345678> mystreamer is live!

#Template Scripting Reference

Custom feed messages use greed's embedded scripting language. Master it with these resources:

• Embed Scripting: Build rich embeds with titles, descriptions, fields, colors, images, and footers.
• Variables: Variable interpolation, conditionals, mentions, and formatting.
• Components: Add buttons, select menus, and text inputs (Components V2).

Key techniques:

• Variables: Wrap any variable in {...} to interpolate — e.g., {twitch.creator.name}.
• Embeds: Each field is its own node — {title: ...}, {description: ...}, {color: #hex}, {image: url}. Open with {embed} when a message mixes plain text and embed fields.
• Fields and buttons: Arguments are separated by &&, never commas or key="value" pairs — {field: Name && Value && inline} and {button: label: Watch && url: https://...}.
• Conditionals: Use {if condition}...{/if} to show content only when conditions are met.

#Common Issues & Troubleshooting

#Profile Lookups

Query profiles and stats from gaming and social platforms. All lookups are one-off commands — they don't create persistent feeds.

#Roblox Profiles

Look up Roblox user profiles, games, groups, and outfit information.

#Rolimons

Look up Roblox item values and trading stats via Rolimons.

#Valorant Profiles

Look up player ranks, agents, weapons, and maps.

#Minecraft

Look up Java Edition player skins and server info.

#Spotify

Search and preview tracks, albums, and artists.

#GitHub

Look up GitHub user profiles and repository information.

#X (Twitter)

Look up X/Twitter profiles and fetch individual posts.

#Instagram Profiles

Instagram lookups work without any feed configuration and need no permissions.

#League of Legends

#Bio Profiles

Look up user profiles from social bio platforms: guns.lol and haunt.gg.

#Fortnite

View Fortnite cosmetics, news, and map information.

#Last.fm Integration

Link your Last.fm account to get Spotify and YouTube links for currently playing tracks.

#Troubleshooting