Discord hub

Discord Announcement API

One public announcement post, with its server, channel, attachments and reactions.

GET /v1/discord/announcement-channels/{channelId}/posts/{messageId}

1 credit Failed requests are free

About this endpoint

GET /v1/discord/announcement-channels/{channelId}/posts/{messageId} returns one public announcement post. The response carries channelId, the server (id, name, description and icon URL), the channel (id, name, topic) and post with its id, text, postedAt, editedAt, attachments and reactions.

Use the message id from a channel page or from a public post URL. If the channel is not a public announcement channel, or the message is not one of its public posts, the route returns lookupStatus: not_found with post: null.

Discord Announcement API FAQ

Where do I get the message id?

From the channel route's messages list or from the post's public URL. The channel id is the first path parameter and the message id is the second.

What is in a post?

id, text, postedAt, editedAt, attachments and reactions. Attachments carry their URL, MIME type, dimensions and alt text; reactions carry the emoji and a count.

Why is the post not found?

The channel must be a public announcement channel and the message must be one of its public posts. A private post, a wrong message id or a regular text channel returns not_found.

How many credits does a post lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.