GDBrowser API

Free to Use 300 per window (299 remaining at test time)
64 C
Measured Score 0 50 100 Speed 6/30 Consistency 8/20 Security 20/20 Browser access 15/15 Transparency 15/15 TESTED 2026-08-10

Overview

GDBrowser API provides a simple interface to the Geometry Dash game servers, letting you fetch level data, player profiles, and leaderboard scores. No authentication is required, which makes it easy to start building fan tools and stat pages right away. It is a community-maintained API ideal for Geometry Dash enthusiasts learning about REST APIs.

Beginner Tip

The API wraps the official Geometry Dash servers, so response times can vary. Cache results locally when possible to reduce load and improve your app speed.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET https://gdbrowser.com/api/search/bloodbath?diff=10&type=0
Result
HTTP 200 · application/json · 1,258 bytes · compressed
Response time
507 ms (median of 3) · fastest 381 ms
Transport
TLSv1.3 · TLS_AES_256_GCM_SHA384 · certificate issued by Let's Encrypt
Browser CORS
Allowed — Access-Control-Allow-Origin: *
Rate limit
300 per window (299 remaining at test time)
Served by
cloudflare
Recorded
2026-08-10

Fields Returned

Top-level fields present in the response we captured, with the type and value we actually received.

Field Type Value received
name string Bloodbath
id string 10565740
description string Whose blood will be spilt in the Bloodbath? W…
author string Riot
playerID string 503085
accountID string 37415
difficulty string Extreme Demon
downloads integer 181578486
likes integer 5569114
disliked boolean false
length string Long
platformer boolean false
stars integer 10
orbs integer 500

Captured Response

Captured from a real request to https://gdbrowser.com/api/search/bloodbath?diff=10&type=0 on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.

JSON Response · Captured
[
  {
    "name": "Bloodbath",
    "id": "10565740",
    "description": "Whose blood will be spilt in the Bloodbath? Who will the victors be? How many will survive? Good luck...",
    "author": "Riot",
    "playerID": "503085",
    "accountID": "37415",
    "difficulty": "Extreme Demon",
    "downloads": 181578486,
    "likes": 5569114,
    "disliked": false,
    "length": "Long",
    "platformer": false,
    "stars": 10,
    "orbs": 500,
    "…": "(31 more fields)"
  }
]

Field Reference

id Unique Geometry Dash level or player ID
name Name of the level or username of the player
author Username of the player who created the level
difficulty Difficulty rating of the level, e.g. Hard, Insane, Demon
stars Star rating awarded to the level by the Geometry Dash team

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://gdbrowser.com/api/search/bloodbath?diff=10&type=0";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist text/html

Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.

HTTP 500 Sending an invalid value for "diff" text/html

Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

-1 response body The Geometry Dash server returned an error or the requested resource was not found
Verify the level name or player username exists in-game before querying the API
Request timeout The upstream Geometry Dash server is slow to respond
Implement a timeout of at least 10 seconds in your HTTP client and add retry logic
Empty results array The search query returned no matching levels or players
Try broader search terms or check that the difficulty and type parameters use correct numeric values

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 6/30
Consistency 8/20
Security 20/20
Browser access 15/15
Transparency 15/15
Endpoint Response Time 507ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Games & Comics
Difficulty Beginner
Endpoint last called: 2026-08-10

Related Tags

Similar APIs

View All →