Discord App Directory Scraper

Scrape public apps from the Discord App Directory by search query and/or category. Each run searches the directory API, then enriches every hit with the application detail endpoint.

Features

• Filter by search query and/or category (same filters as the website)
• Paginated search with a configurable limit
• Detail enrichment: guild count, install URL, popular commands, support server, flags
• Proxy support via Apify Proxy

Input

Provide at least one of searchQuery or category.

searchQuery

• Type: string
• Description: Text matched against App Directory listings (website search box).
• Example: carl

category

• Type: string (select)
• Description: Website “Show” category filter. Readable labels only; mapped to Discord’s numeric category_id internally.
• Options: Games, Entertainment, Moderation and Tools, Social, Utilities
• Example: Games

limit

• Type: integer
• Description: Maximum number of apps to scrape. Set to 0 for no limit. Default is 10.
• Example: 100

proxyConfiguration

• Type: object
• Description: Proxy settings. Datacenter proxies are used by default; switch to RESIDENTIAL if requests are blocked.
• Example:

  { "useApifyProxy": true }
  

Input example

{
  "searchQuery": "carl",
  "category": "Games",
  "limit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Sorting is not available: the App Directory UI and search API do not expose a sort control.

Output

One dataset row per successfully enriched app.

Field	Type	Description
id	string	Application ID
name	string	Display name
description	string	Short description
iconUrl	string	CDN icon URL
tags	string[]	Tags
categories	object[]	Categories (id, name)
isVerified	boolean	Verified flag
isDiscoverable	boolean	Discoverable flag
isMonetized	boolean	Monetized flag
guildCount	integer	Approximate install / guild count
detailedDescription	string	Long directory description
popularCommands	object[]	Popular slash commands
botUsername / botId	string	Linked bot user
guildName / guildMemberCount	—	Support server info
customInstallUrl	string	OAuth / install link
directoryUrl	string	App Directory page URL
searchQuery / category	string	Filters used for the run
scrapedAt	string	ISO timestamp

Example row

{
  "id": "1076935463698448404",
  "name": "Carl Johnson",
  "description": "A Discord bot designed for Grand Theft Auto...",
  "iconUrl": "https://cdn.discordapp.com/app-icons/1076935463698448404/....png?size=256",
  "tags": ["GTA Open Multiplayer"],
  "categories": [{ "id": 6, "name": "Games" }],
  "isVerified": true,
  "isDiscoverable": true,
  "isMonetized": false,
  "guildCount": 92,
  "customInstallUrl": "https://discord.com/oauth2/authorize?client_id=...",
  "directoryUrl": "https://discord.com/discovery/applications/1076935463698448404",
  "searchQuery": "carl",
  "category": "Games",
  "scrapedAt": "2026-09-19T00:00:00.000Z"
}

Handling of empty / failed results

Inputs that yield no apps are kept out of the dataset and reported in the RUN_REPORT key-value store record, with warnings in the log.

• Empty search: no apps match the filters — run succeeds with zero rows.
• Detail 404 / failed enrichments: skipped and listed in RUN_REPORT.
• All requests blocked: run fails with a clear message (try residential proxies).