Discord

List Discord announcement channel

List the latest public posts of a Discord announcement channel, with text, attachments and reactions.

GET/v1/discord/announcement-channels/{channelId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
channelIdstringrequiredpath

Channel id, 1 to 20 digits and at most 9223372036854775807, e.g. `267631170882240512`.

pattern: ^[0-9]{1,20}$

Response fields
38

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the channel id is not a public announcement channel.

one of: found, not_found, restricted

The channel and its latest public posts when found.

datachannelid
string

Channel id.

datachannelname
stringnullable

Channel name.

datachanneltopic
stringnullable

Channel topic.

The server the channel belongs to.

datachannelserverid
string

Server id.

datachannelservername
string

Server name.

datachannelserverdescription
stringnullable

Server description.

datachannelservericonUrl
stringnullable

Server icon URL.

datachannelserversplashUrl
stringnullable

Discovery splash URL.

datachannelserverbannerUrl
stringnullable

Server banner URL.

datachannelserverinviteCode
stringnullable

The server's vanity invite code, when it has one.

datachannelservermembers
integernullable

Indexed member count.

datachannelserveronline
integernullable

Indexed online count.

The latest public posts, newest first.

datachannelmessages[]id
string

Message id.

datachannelmessages[]text
string

The message text.

datachannelmessages[]postedAt
stringnullable

When it was posted, ISO 8601 UTC.

datachannelmessages[]editedAt
stringnullable

When it was edited, ISO 8601 UTC; null when never edited.

Files attached to the post.

datachannelmessages[]attachments[]url
string

The attachment URL. Its signed query parameters expire, so the link is time-limited.

datachannelmessages[]attachments[]mediaUrl
stringnullableoptional

A second URL for the attachment on Discord's media host, when present.

datachannelmessages[]attachments[]contentType
stringnullable

MIME type, when given.

datachannelmessages[]attachments[]width
integernullable

Width in pixels, when given.

datachannelmessages[]attachments[]height
integernullable

Height in pixels, when given.

datachannelmessages[]attachments[]description
stringnullable

Alt text, when present.

Reactions on the post.

datachannelmessages[]reactions[]emojiId
stringnullable

Custom emoji id, or null.

datachannelmessages[]reactions[]emojiName
stringnullable

Emoji name, or null.

datachannelmessages[]reactions[]animated
booleannullable

Whether the emoji is animated.

datachannelmessages[]reactions[]count
integer

How many people reacted.

datachanneltruncated
boolean

True when the channel has more posts than this page and no cursor continues past it.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/discord/announcement-channels/538844350856298526" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Announcement channel.