Skip to content
Scrappa Get API key
Top.gg API 1 credit / request

Top.gg Bot and Server Search

GET https://scrappa.co/api/topgg/search

Search public Discord bots or servers. Every node carries the public snowflake (externalId), the internal id used by the reviews and detail routes, name, full description, tags with counts, votes, member count from socialCount, full-size image URL, ISO 8601 createdAt, rating and review count. MONTHLY_VOTES is the only supported sort. Paging uses a real skip offset. One credit per successful page with nodes.

Top.gg Bot and Server Search 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/topgg/search
Auth header
x-api-key
Cost
1 credit / request
type = example
Response preview
200 OK
Example JSON appears below when a response schema is available for this endpoint.

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

5 optional filters available.

type string Required

BOT or SERVER.

Example value example
query string Optional

Optional search text.

Example value coffee shops
tag string Optional

Optional tag slug.

Example value example
skip integer Optional

Offset for pagination.

Example value 10
limit integer Optional

Items per page, 1 to 50.

Example value 10
locale string Optional

en or de.

Example value en-US

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

HTTP 422

Bad type, sort or paging value. Not charged.

404

HTTP 404

No entity matches. Not charged.

503

HTTP 503

Upstream failure or rejected query. Not charged.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.