Discord Server Scraper

Discord Server Scraper — Extracto API reference

Find public Discord servers by keyword or resolve server and invite links. Collect server metadata, member and online counts, public links and available page details.

Collection scope

Collect public server metadata, not messages or member lists. Search the public directory or supply a server page, HTTPS invite link or invite code. Optional page details include available descriptions, features and social links. Invite/page availability and counts can change; unavailable fields remain empty. Private channels and authenticated server content are not included.

Using Extracto

Extracto provides a web interface and HTTP API for submitting scraping tasks, tracking their status and retrieving structured results. Some parsers use third-party scraping providers for execution. Your Extracto account, API key and credit balance are managed at extracto.cloud.

Create an account at https://extracto.cloud/register, confirm your email and create an API key at https://extracto.cloud/api-keys. You can also configure and run this parser in the web interface at https://extracto.cloud/marketplace/discord-server-scraper.

Pricing and credits

Current Extracto price: $0.736156 / 1,000 results. Extracto charges your credit balance for parser usage. 1,000 credits correspond to $1 USD. The displayed rate includes Extracto pricing; additional enabled options are shown in the estimate. Review the cost estimate in the web interface or POST your request body to https://extracto.cloud/api/v1/parsers/discord-server-scraper/estimate before launching a task. An estimate does not start scraping. Credit packages are listed at https://extracto.cloud/pricing; billing details are at https://extracto.cloud/docs#billing.

Input

Send JSON with the parser settings inside an input object. The example is a starting point: replace the sources and limits with your own permitted targets. Launching it starts a real task and can spend credits.

{
    "input": {
        "keywords": [
            "python"
        ],
        "startUrls": [],
        "category": "",
        "maxItems": 20,
        "includeDetails": true
    }
}

• keywords (array, optional)
• category (string, optional)
• startUrls (array, optional)
• maxItems (integer, required)
• includeDetails (boolean, optional)

Requests and authentication

Use your Extracto key in the X-API-KEY header. Send Content-Type: application/json and Accept: application/json. Keep the key private on your server.

POST https://extracto.cloud/api/v1/parsers/discord-server-scraper — wait for a synchronous result. Successful output is in data, with the result count in count and usage in meta.credits. POST https://extracto.cloud/api/v1/parsers/discord-server-scraper/queue — submit a queued task. Save run.id from the HTTP 202 response. GET https://extracto.cloud/api/v1/parser-runs/{run_id} — check a saved task using the same account's API key. Poll about once every five seconds while its status is queued or running. Stop at ok, partial, cancelled or error. Saved results are in run.result; failures are described in run.error.

Integration examples, response formats, errors and limits: https://extracto.cloud/docs.

Output

Returned fields depend on the parser, input and source availability. A successful task can return no matching records. Availability and completion time can change when the source website changes. The following sample is illustrative documentation data, not a customer run or a guarantee of results:

[
    {
        "name": "CodeSupport",
        "memberCount": 36016,
        "onlineCount": 2277,
        "locale": "en-US",
        "category": "General",
        "url": "https://discord.com/servers/codesupport-240880736851329024",
        "id": "240880736851329024",
        "inviteUrl": null,
        "features": [
            "AGE_VERIFICATION_LARGE_GUILD",
            "APPLICATION_COMMAND_PERMISSIONS_V3",
            "AUTO_MODERATION",
            "CHANNEL_ICON_EMOJIS_GENERATED",
            "COMMUNITY",
            "COMMUNITY_EXP_LARGE_GATED",
            "CONSIDERED_EXTERNALLY_DISCOVERABLE",
            "DISCOVERABLE",
            "ENABLED_DISCOVERABLE_BEFORE",
            "GUILD_ONBOARDING",
            "GUILD_ONBOARDING_EVER_ENABLED",
            "GUILD_ONBOARDING_HAS_PROMPTS",
            "GUILD_SERVER_GUIDE",
            "GUILD_WEB_PAGE_VANITY_URL",
            "MEMBER_VERIFICATION_GATE_ENABLED",
            "NEW_THREAD_PERMISSIONS",
            "PREVIEW_ENABLED",
            "SOUNDBOARD",
            "TEXT_IN_VOICE_ENABLED",
            "THREADS_ENABLED",
            "TIERLESS_BOOSTING_SYSTEM_MESSAGE",
            "WELCOME_SCREEN_ENABLED"
        ],
        "about": null,
        "socialLinks": null,
        "verificationLevel": null,
        "boostTier": null
    }
]

• name (string): Server returned by the public source; can be absent.
• memberCount (integer): Members returned by the public source; can be absent.
• onlineCount (integer): Online returned by the public source; can be absent.
• locale (string): Language returned by the public source; can be absent.
• category (string): Category returned by the public source; can be absent.
• url (string): Server URL returned by the public source; can be absent.
• id (string): Public server identifier.
• inviteUrl (string): Invitation link when resolved or returned.
• features (array): Available server feature identifiers.
• about (string): Long public page description when details are enabled and available.
• socialLinks (object): Public social links when returned.
• verificationLevel (integer): Verification level when invite resolution returns it.
• boostTier (integer): Boost tier when returned.

Example uses

• Discover public communities around a topic.
• Compare public server size and online counts.
• Export server directories and public invitation metadata.

Responsible use and support

Use this parser only for data you are permitted to access and process. Follow applicable laws, source website terms and Extracto's acceptable-use policy: https://extracto.cloud/acceptable-use. For help, email [email protected] and include the parser name and run ID. Never send your API key. Terms: https://extracto.cloud/terms Privacy: https://extracto.cloud/privacy Refund policy: https://extracto.cloud/refund-policy