API Access

API key access for Patreon supporters

api

BeatConnect API

Build osu! tools and applications on top of our beatmap database, with search, metadata and downloads through your personal API key.

volunteer_activism Become a Patron

What You Get

vpn_key

Personal API Key

An API key is created automatically when your pledge is active, for authenticated access to the search, beatmap and pack endpoints.

link

No Captcha on Direct Links

Direct /b/ download links skip the captcha and the hourly per-IP limit while you are signed in or send your API key.

archive

Download All as One .zip

Download All for packs, playlists and liked maps as one .zip, written straight to disk from maps already cached on BeatConnect.

star

Supporter Badge

A supporter badge on your account menu and profile.

Free vs Patreon

FeatureFree Patreon
Browse, Search & Download Beatmapscheck_circlecheck_circle
Personal API KeyBy applicationAutomatic
No Captcha on Direct Linkscancelcheck_circle
Download All as One .zipcancelcheck_circle
Supporter Badgecancelcheck_circle

Usage Guidelines

  • verifiedFair Use: Please use the API responsibly. Avoid excessive automated requests that could impact service for others.
  • speedRecommended Rates: For bulk operations, we recommend spacing requests at 100ms intervals to ensure optimal performance.
  • blockProhibited Uses: No reselling API access, no scraping for competing services, no abusive automated downloads.
  • attributionAttribution: When building public tools, please credit BeatConnect as your data source.

Terms & Conditions

  • linkAPI access is tied to an active Patreon subscription.
  • key_offYour API token will be revoked if your subscription is cancelled or expires.
  • securityKeep your API token secure. Do not share it publicly or commit it to repositories.
  • cloud_offService availability is not guaranteed. Maintenance and updates may cause temporary downtime.
  • gavelWe reserve the right to revoke access for violations of these terms.

Getting Started

1

Subscribe on Patreon

Join our Patreon to unlock API access.

2

Link Your Account

Go to your profile and click "Link Patreon Account" to connect your membership.

3

Get Your Token

Find your personal API token in your profile settings.

4

Start Building

Use your token to authenticate API requests and start building.

Example Request

curl -H "Token: YOUR_API_TOKEN" \
  "https://beatconnect.io/api/search/?q=freedom%20dive"

Frequently Asked Questions

Ready to Get Started?

Join our Patreon to get your personal API key and support BeatConnect.

volunteer_activism Become a Patron