Search
/api/topgg/search
Search public bots or servers with votes, tags, ratings and counts
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.
Try it now
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.
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"
{
"success": true,
"data": {"items": [{"externalId": "411916947773587456", "name": "Example", "votes": 10}], "count": 1},
"meta": {"endpoint_family": "search", "billable": true, "credits": 1}
}
Structured data for real applications. Here are some ideas.
Find public Discord bots by query or tag with votes, ratings and server counts.
Search Discord servers with the same shape and page with a real offset.
Read reviews by the internal id returned with every search node.
Top.gg scraper API
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.
Search bots by query and read the public id and internal id from one node.
Open Top.gg Search API docsSend the internal id from that node to the reviews route.
Open Top.gg Reviews API docsEverything you need in one API.
/api/topgg/search
Search public bots or servers with votes, tags, ratings and counts
/api/topgg/tags
Localized tag suggestions with counts
/api/topgg/reviews
Reviews of one entity by internal id
/api/topgg/bot
One bot resolved by the id from search
/api/topgg/server
One server resolved by the id from search
/api/topgg/widget
PNG widget badge as base64 with its image URL
See how Scrappa compares to Top.gg website.
| Feature | Scrappa | Top.gg website |
|---|---|---|
| Structured JSON | HTML pages only | |
| Public data access | API key only | Token required |
| Numeric votes and counts | Text on the page | |
| Price per 1k requests | From $0.20 | Not available |
| Unified API key | Yes (500+ APIs) | Not available |
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.