# UrlBae

> UrlBae is a self-hosted link management platform: a URL shortener with branded
> short links, link-in-bio pages, dynamic QR codes, and click analytics. Links can
> be targeted by country, device or language, rotated for A/B testing, expired on a
> date or click count, and tracked with custom pixels.

UrlBae serves two domains from one application:

- **urlbae.com** — main site, dashboard, admin and API
- **urlbae.info** — short-link domain (its root redirects to urlbae.com)

Short links resolve as `https://urlbae.info/{alias}` or `https://urlbae.com/{alias}`.
Users on paid plans can also point their own branded domain at the service.

## Core pages

- [Home](https://urlbae.com/): Shorten a link, overview of features
- [Pricing](https://urlbae.com/pricing): Current plans and what each includes
- [Developer API](https://urlbae.com/developers): API reference with endpoints, parameters and example responses
- [Help centre](https://urlbae.com/help): Guides and frequently asked questions
- [Contact](https://urlbae.com/contact): Get in touch with support
- [Affiliate programme](https://urlbae.com/affiliate): Referral scheme details
- [Report a link](https://urlbae.com/report): Report abuse, phishing or malware behind a short link

## Accounts

- [Sign in](https://urlbae.com/user/login): Existing account login
- [Create an account](https://urlbae.com/user/register): Free registration, no card required

## Plans

- **Free** — 50 links/month, 2,000 tracked clicks, 30-day analytics retention,
  unlimited bio pages and QR codes, API access at 10 requests/minute
- **Pro (£14.99/mo or £149/yr)** — 1,000 links/month, 25,000 clicks, 12-month
  retention, 1 branded domain, custom aliases, geo/device/language targeting,
  A/B testing, QR logos and frames, API at 60 requests/minute. 7-day trial
- **Business (£39/mo or £390/yr)** — 10,000 links/month, 250,000 clicks, unlimited
  retention, 10 branded domains, 5 team members, premium domains,
  API at 120 requests/minute. 7-day trial

Prices are in GBP. There is no lifetime plan.

## API

The REST API is at `https://urlbae.com/api`. Requests authenticate with a bearer
token: `Authorization: Bearer <api-key>`. An API key is generated per account and
is available in account settings. Rate limits are per minute and depend on plan;
each response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and
`X-RateLimit-Reset` headers.

Representative endpoints:

- `GET  /api/account` — account details and plan status
- `GET  /api/urls` — list the authenticated user's links
- `POST /api/url/add` — create a short link
- `GET  /api/url/{id}` — retrieve a single link
- `POST /api/oauth/token` — OAuth token exchange

Full parameters, response shapes and error codes are documented at
[/developers](https://urlbae.com/developers).

## Legal

- [Terms of service](https://urlbae.com/page/terms)
- [Privacy policy](https://urlbae.com/page/privacy)

## Notes for automated clients

- Short links return `301 Moved Permanently` with the destination in the
  `Location` header. Follow redirects to resolve a final URL.
- Do not crawl or enumerate short-link aliases. Aliases are user content, some
  links are password-protected or click-limited, and automated traversal is
  treated as abuse.
- Respect the rate limit headers on API responses rather than retrying blindly.
- To report a malicious destination behind a short link, use
  [/report](https://urlbae.com/report) rather than contacting hosting providers.