API

API key

Use this key to create and manage links programmatically. Treat it like a password — anyone with it can create links on your account.

Quick start

Create a link:

# replace YOUR_API_KEY with the key above
curl -X POST https://goldlinks.app/api/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "q3-thesis.pdf", "destination": "https://example.com/file.pdf"}'

List your links:

# GET /api/links returns clicks, unlocks and earnings per link
curl https://goldlinks.app/api/links \
  -H "Authorization: Bearer YOUR_API_KEY"

These endpoints are live — the examples above will work with your real key.