Top.gg API

Top.gg API for Discord Bot and Server Search, Tags, Reviews and Widgets

Scrappa's Top.gg API returns public Discord bot and server directory data as JSON: search bots or servers with votes, tags, ratings and counts, complete localized tags, read reviews and fetch a PNG widget badge. Only public logged-out data is returned. Scrappa is independent and not affiliated with Top.gg.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
6
Endpoints
2
Entity types
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/topgg/search?type=BOT&query=music&limit=5" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "data": {"items": [{"externalId": "411916947773587456", "name": "Example", "votes": 10}], "count": 1},
  "meta": {"endpoint_family": "search", "billable": true, "credits": 1}
}

What you can build

Structured data for real applications. Here are some ideas.

Bot Discovery

Find public Discord bots by query or tag with votes, ratings and server counts.

Server Research

Search Discord servers with the same shape and page with a real offset.

Review Analysis

Read reviews by the internal id returned with every search node.

Top.gg scraper API

Top.gg API for bots, servers and reviews

Search returns both the public snowflake and the internal id of every node. Use the internal id for detail and reviews. Exact snowflake matches are accepted where search finds them. Ids from search are accepted unchanged. Responses are JSON with success, data and a meta block.

Search bots or servers with offset paging and localized tags.

Every node carries votes, tags, member count, rating and review count.

Open detail and reviews with the internal id from a search node.

Failed requests and empty results are never charged.

Choose the right Top.gg API endpoint

Find a bot id

Search bots by query and read the public id and internal id from one node.

Open Top.gg Search API docs

Read its reviews

Send the internal id from that node to the reviews route.

Open Top.gg Reviews API docs

Available endpoints

Everything you need in one API.

Scrappa vs Top.gg website

See how Scrappa compares to Top.gg website.

Structured JSON
Scrappa
Top.gg website
HTML pages only
Public data access
Scrappa
API key only
Top.gg website
Token required
Numeric votes and counts
Scrappa
Top.gg website
Text on the page
Price per 1k requests
Scrappa
From $0.20
Top.gg website
Not available
Unified API key
Scrappa
Yes (500+ APIs)
Top.gg website
Not available

Key features

Bot and server search with votes, tags, ratings and counts
Offset paging with a real skip value
Localized tag suggestions with counts
Reviews and by-id detail from search ids
PNG widget badge as an enrichment route
Failed and empty requests are not charged

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Top.gg.

The internal id from the unaliased id field of a search node. The public snowflake returns an empty list.

Search is always ranked by monthly votes. Other sort values are rejected before any upstream call.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit. Failed requests are never charged.

Start using the Top.gg API

Sign up and get 500 free credits. No credit card required.