# buygolinks.com

> buygolinks is a branded short-link service with mobile deep linking and Amazon affiliate geo-routing. Short links live at `https://buygolinks.com/{code}`; the management API lives at `https://app.buygolinks.com/api/*`.

The API is JSON over HTTPS. Authenticate with a personal access token (format `bgl_<24 base62>`) sent as `Authorization: Bearer <token>`. Create tokens via `POST /api/api-keys`. Supabase JWTs also work but are scoped to UI sessions and expire fast — prefer personal access tokens for any programmatic use.

Short-link clicks fire `ascsubtag=link-{code}-{store}` on Amazon redirects so you can attribute conversions in your Amazon Associates report.

## Docs

- [API reference (HTML)](https://docs.buygolinks.com/): human-readable reference for every endpoint.
- [OpenAPI 3.1 spec](https://docs.buygolinks.com/openapi.yaml): machine-readable spec covering all endpoints, request/response shapes, and error codes. Import into Postman, OpenAI Custom GPT actions, or any OpenAPI client.
- [Full reference (single markdown file)](https://docs.buygolinks.com/llms-full.txt): every endpoint inlined in one file, optimized for LLM ingestion in a single fetch.

## Core concepts

- [Links](https://docs.buygolinks.com/#links): create, list, edit, archive short links. Amazon URLs auto-detect ASIN and trigger geo-routing.
- [Statistics](https://docs.buygolinks.com/#statistics): aggregated click stats (by day, country, device, browser, referrer, hour, weekday) for the account or a single link.
- [Amazon affiliate tags](https://docs.buygolinks.com/#amazon-tags): per-store affiliate tags. The resolver picks the visitor's local Amazon store and appends the right tag.
- [Collections](https://docs.buygolinks.com/#collections): group links into folders. Optional rotator alias `/c/{alias}` randomly picks one member per visit.
- [Tracking pixels](https://docs.buygolinks.com/#tracking-pixels): Meta/TikTok/Google pixels that fire on the deep-link interstitial.
- [Custom domains](https://docs.buygolinks.com/#domains): serve short links from your own hostname (e.g. `go.acme.com`) via Cloudflare for SaaS. Paid plans only.
- [API keys](https://docs.buygolinks.com/#api-keys): personal access tokens for programmatic access.

## Resolver

- Public, no auth: `GET https://buygolinks.com/{code}` redirects (or returns a mobile deep-link page) and logs the click. Each click records country (CF-IPCountry), device, browser, referrer, language.