# Social Fetch API - Discord endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

17 documented Discord operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/discord/invites/{code}
Get Discord invite
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/invites/code/get.mdx
SDK: client.discord.getInvite({ code: "python" })
Parameters:
- code (required, string) - Invite code (a vanity code or a temporary code), 2 to 32 letters, digits, underscores or hyphens. Vanity codes are case-insensitive; temporary codes are case-sensitive.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/invites/python" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/servers/{serverId}
Get Discord server
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/servers/serverid/get.mdx
SDK: client.discord.getServer({ serverId: "267624335836053506", include: "widget" })
Parameters:
- serverId (required, string) - Server id, 17 to 20 digits and at most 9223372036854775807, e.g. `267624335836053506`. A server with no public page or subscription store page returns `not_found`.
- include (optional, array) - `widget` adds the public guild widget summary. Default: none.
- announcements (optional, boolean) - Include the announcement channels for this server. Default: true.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/servers/267624335836053506?include=widget" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/servers
List Discord servers
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/servers/get.mdx
SDK: client.discord.listServers({ category: "gaming" })
Parameters:
- category (optional, string, enum: gaming | music | entertainment | science-tech | education) - Directory category: `gaming`, `music`, `entertainment`, `science-tech` or `education`.
- page (optional, integer) - Page number, 1 to 250. Omit for the first page. The directory reorders between requests, so numbered pages can repeat servers; follow `page.nextCursor` instead.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/servers?category=gaming" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/servers/search
Search Discord servers
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/servers/search/get.mdx
SDK: client.discord.searchServers({ query: "python" })
Parameters:
- query (required, string) - Words to search the public server directory for. Case-insensitive; whole-word and prefix matching.
- category (optional, string, enum: gaming | music | entertainment | science-tech | education) - Directory category: `gaming`, `music`, `entertainment`, `science-tech` or `education`.
- page (optional, integer) - Page number, 1 to 6. Each page returns up to 12 servers; omit for the first page and pass `page.nextCursor` to continue.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/servers/search?query=python" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/servers/{serverId}/widget
Get Discord server widget
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/servers/serverid/widget/get.mdx
SDK: client.discord.getServerWidget({ serverId: "267624335836053506" })
Parameters:
- serverId (required, string) - Server id, 17 to 20 digits and at most 9223372036854775807, e.g. `267624335836053506`. A server whose owner disabled the widget returns `lookupStatus: restricted`.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/servers/267624335836053506/widget" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/servers/index
List Discord server index
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/servers/index/get.mdx
SDK: client.discord.listServerIndex({ page: 1 })
Parameters:
- page (optional, integer) - Page number, 1 to 200. Each page returns up to 500 ids and slugs; omit for the first page and pass `page.nextCursor` to continue.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/servers/index?page=1" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/games/index
List Discord game index
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/games/index/get.mdx
SDK: client.discord.listGameIndex({ page: 1 })
Parameters:
- page (optional, integer) - Page number, 1 to 60. Each page returns up to 500 ids and slugs; omit for the first page and pass `page.nextCursor` to continue.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/games/index?page=1" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/games/trending
List Discord trending games
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/games/trending/get.mdx
SDK: client.discord.listTrendingGames({ category: "shooter" })
Parameters:
- week (optional, string) - Week date, YYYY-MM-DD (Discord publishes on Thursdays). Omit for the latest week.
- category (optional, string, enum: adventure | crafting | fantasy | fps | horror | indie | mmo | open-world | rpg | sandbox | sci-fi | shooter | simulation | sports | story-rich | strategy | survival | tactical) - Trending category, one of the 18 slugs Discord publishes (e.g. `shooter`, `rpg`, `survival`).
- include (optional, array) - `weeks` adds the published week list (overall and per category). Default: none.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/games/trending?category=shooter" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/games/{applicationId}
Get Discord game
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/games/applicationid/get.mdx
SDK: client.discord.getGame({ applicationId: "1402418703554842694" })
Parameters:
- applicationId (required, string) - Application id, 1 to 20 digits and at most 9223372036854775807, e.g. `457300488199733265`. Bots and applications without a game page return `not_found`.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/games/1402418703554842694" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/applications/{applicationId}
Get Discord application
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/applications/applicationid/get.mdx
SDK: client.discord.getApplication({ applicationId: "936929561302675456" })
Parameters:
- applicationId (required, string) - Application id, 1 to 20 digits and at most 9223372036854775807, e.g. `936929561302675456`.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/applications/936929561302675456" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/applications/{applicationId}/similar
List similar Discord applications
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/applications/applicationid/similar/get.mdx
SDK: client.discord.listSimilarApplications({ applicationId: "936929561302675456" })
Parameters:
- applicationId (required, string) - Application id, 1 to 20 digits and at most 9223372036854775807, e.g. `936929561302675456`.
- page (optional, integer) - Page number, 1 to 25. Omit for the first page; use the previous response's `page.nextCursor` to continue.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/applications/936929561302675456/similar" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/applications/index
List Discord application index
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/applications/index/get.mdx
SDK: client.discord.listApplicationIndex({ page: 1 })
Parameters:
- page (optional, integer) - Page number, 1 to 50. Each page returns up to 500 application ids; omit for the first page and pass `page.nextCursor` to continue.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/applications/index?page=1" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/applications/collections
List Discord application collections
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/applications/collections/get.mdx
SDK: client.discord.listApplicationCollections()
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/applications/collections" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/templates/{code}
Get Discord template
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/templates/code/get.mdx
SDK: client.discord.getTemplate({ code: "hgM48av5Q69A" })
Parameters:
- code (required, string) - Guild template code, 1 to 64 letters, digits, underscores or hyphens.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/templates/hgM48av5Q69A" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/announcement-channels/{channelId}
List Discord announcement channel
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/announcement-channels/channelid/get.mdx
SDK: client.discord.listAnnouncements({ channelId: "538844350856298526" })
Parameters:
- channelId (required, string) - Channel id, 1 to 20 digits and at most 9223372036854775807, e.g. `267631170882240512`.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/announcement-channels/538844350856298526" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/announcements/index
List Discord announcement index
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/announcements/index/get.mdx
SDK: client.discord.listAnnouncementIndex({ page: 1 })
Parameters:
- page (optional, integer) - Page number, 1 to 10. Each page returns up to 500 URLs; omit for the first page and pass `page.nextCursor` to continue.
- cursor (optional, string) - Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/announcements/index?page=1" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/discord/announcement-channels/{channelId}/posts/{messageId}
Get Discord announcement
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/discord/announcement-channels/channelid/posts/messageid/get.mdx
SDK: client.discord.getAnnouncement({ channelId: "538844350856298526", messageId: "1565380934721605652" })
Parameters:
- channelId (required, string) - Channel id, 1 to 20 digits and at most 9223372036854775807, e.g. `267631170882240512`.
- messageId (required, string) - Message id, 1 to 20 digits and at most 9223372036854775807, e.g. `267624335836053506`.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/discord/announcement-channels/538844350856298526/posts/1565380934721605652" \
  -H "x-api-key: YOUR_API_KEY"