← ownyourclick.com Documentation

How everything works

Every feature, from your first tracked link to pulling your data over the API.

Getting started

ownyourclick gives every link you share a memory: who clicked it, from where, on what device — and, when you want it, which click turned into a signup or sale. Create a free account at app.ownyourclick.com, and you're looking at your dashboard in under a minute. The Free plan includes 8 active links and 1,000 tracked clicks per month, forever.

A UTM link is a short, branded link with campaign parameters (utm_source, utm_medium, utm_campaign…) baked in — so analytics tools, including ours, know exactly which post, ad or email drove each click.

  1. Go to UTM Links → New link.
  2. Paste the destination URL (the page people should land on).
  3. Fill the UTM fields — or pick one of your saved presets. source is where the link lives (instagram, newsletter), medium is the type (social, email), campaign is the push it belongs to (summer-launch).
  4. Choose a custom back-half if you like — go.ownyourclick.com/summer — and hit create.

Share that one link everywhere the campaign runs. Every click is recorded with country, city, device, browser, language, and referrer.

Need a clean link without campaign parameters? Short Links is one-paste shortening — same analytics, no UTM ceremony. You can re-point a short link to a new destination at any time without changing the link itself (useful for printed material and bios).

App Opener

Instagram, TikTok and Facebook open links inside their own in-app browser — where your audience isn't logged in to YouTube, can't subscribe, and often bounces. An App Opener link breaks out of the in-app browser and opens the destination in the real app. Use it whenever you're sending social audiences to YouTube or another app: create the link under App Opener, paste your destination, share the generated link. Every jump is counted.

Bio Site

Your link-in-bio page, with every button tracked. Under Bio Site:

  1. Create a page and set your shared brand profile (photo, title, bio, social icons) — it's reused across all your bio pages.
  2. Add buttons for each destination. Each button's taps are tracked individually.
  3. Make separate pages per platform (an "Instagram bio" and a "YouTube bio") to see which platform actually sends the traffic.

Views, taps, and (with the snippet) conversions all show on the page's analytics.

QR Codes

Every link can become a QR code under QR Codes — download and print it. Scans are clicks like any other, so the same analytics (including city-level location) apply to your offline material.

Analytics

The Analytics page is workspace-wide: click timeline, uniques, conversions, and breakdowns by referrer, country, city, device, browser and language, with any date range. Every number can also be exported as CSV, or pulled programmatically through the API.

Conversion tracking (the snippet)

Clicks tell you what got attention; conversions tell you what made money. To connect the two, add our tiny first-party snippet to the site where conversions happen (your site — no third-party cookies, no fingerprinting):

<script async src="https://go.ownyourclick.com/oyc.js"></script>

Then tell it what counts as a conversion — two ways:

MethodHowUse when
URL matchIn the link's settings, set the conversion to a URL like /thank-you. Any visitor who arrived via your link and later lands on that page is counted.You have a thank-you / order-confirmation page.
Button attributeAdd data-oyc="signup" to any button or link on your page. Clicks on it convert.The conversion is a click (book a call, download, buy).

Attribution is first-party: the visitor's click id (?oyc=…) travels with them from your link to your site, so the conversion is tied to the exact click — and the exact post — that caused it.

White label (custom domain)

On paid plans, put short links and bio pages on your own domain. Under White Label, enter a domain you own (e.g. go.yourbrand.com), add the CNAME record we show you at your DNS provider, and we handle SSL automatically. Your links then read as your brand end to end.

Team

Invite teammates from Settings → Team. Members see and manage the workspace's links and analytics; billing and API keys stay owner-only. Free includes 1 seat, Pro 2, Business 10.

Plans & billing

Free: 8 active links, 1,000 tracked clicks/month. Pro: 25 links, 15,000 clicks/month, custom domain. Business: unlimited links and clicks. Payments are handled by our merchant of record (cards, and UPI for INR); plans are month-to-month with a 30% discount on annual. If you downgrade, links over the new limit are paused, never deleted — and their history is kept. See the refund policy.

API

Everything the dashboard shows, you can pull over REST. Every new feature we ship gets API coverage as a rule, so you can build on your data without waiting.

Authentication

Create a key under Settings → API (workspace owners only). The full key is shown once — store it safely. Send it as a Bearer token:

curl https://app.ownyourclick.com/api/v1/workspace \
  -H "Authorization: Bearer oyc_YOUR_KEY"

Endpoints

EndpointReturns
GET /api/v1/workspaceWorkspace id, name, plan, lifetime clicks.
GET /api/v1/linksAll links/pages with kind, status, clicks and conversions.
GET /api/v1/links/:id/stats?from&toPer-link clicks, uniques, conversions + daily timeline. from/to are epoch-ms; default last 30 days.
GET /api/v1/analytics/summary?from&toWorkspace-wide clicks, uniques, conversions.
GET /api/v1/analytics/breakdown?by=countryClicks grouped by country, city, referrer, browser, device or language.

Example: your top countries this month

curl "https://app.ownyourclick.com/api/v1/analytics/breakdown?by=country" \
  -H "Authorization: Bearer oyc_YOUR_KEY"

{"by":"country","rows":[{"key":"IN","clicks":812},{"key":"SG","clicks":304}, …]}
Keys grant read access to your whole workspace — treat them like passwords. Revoke a key any time from Settings → API; revocation is immediate.

Still stuck?

Email agneljohn@errormakesclever.com — a human reads it.