# Top.gg Bot and Server 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.

- **Documentation:** [https://scrappa.co/docs/topgg-api/topgg_search](https://scrappa.co/docs/topgg-api/topgg_search)
- **API group:** Top.gg API
- **Endpoint:** `GET https://scrappa.co/api/topgg/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | Yes | BOT or SERVER. |
| `query` | string | No | Optional search text. |
| `tag` | string | No | Optional tag slug. |
| `skip` | integer | No | Offset for pagination. |
| `limit` | integer | No | Items per page, 1 to 50. |
| `locale` | string | No | en or de. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | Bad type, sort or paging value. Not charged. |
|  | Error | No entity matches. Not charged. |
|  | Error | Upstream failure or rejected query. Not charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
