api

BeatConnect API

Build powerful osu! tools and applications with unlimited access to our beatmap database. Get direct download links, search capabilities, and more.

volunteer_activism Become a Patron

What You Get

all_inclusive

Unlimited API Requests

No rate limiting on API calls. Build your applications without restrictions.

cloud_download

Unlimited Downloads

Download as many beatmaps as you need without daily or monthly limits.

link

Direct Download Links

Access direct download URLs for seamless integration with your tools.

vpn_key

Personal API Token

Get your own secure API token for authenticated access to all endpoints.

support_agent

Priority Support

Get help faster with priority support for API-related questions.

menu_book

Full Documentation

Access comprehensive API documentation with examples and guides.

Free vs Patreon

FeatureFree Patreon
Browse & Search Beatmapscheck_circlecheck_circle
Manual DownloadsLimitedUnlimited
API Accesscancelcheck_circle
Rate LimitsStandardNone
Direct Download Linkscancelcheck_circle
Priority Supportcancelcheck_circle

Usage Guidelines

  • verifiedFair Use: While there are no hard limits, 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

Connect your BeatConnect account with your Patreon 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 unlock unlimited API access and support BeatConnect.

volunteer_activism Become a Patron