1. Home
  2. Integrations
  3. REST API

REST API

The complete REST API to automate all your links and QR codes

Every TinyLink screen has its routes: short links, UTM, scheduling, QR codes, pages, components, tags and statistics. Your scripts, your CRM and your Make, Zapier or n8n scenarios create in one request what used to take ten clicks. The documentation gives a sample request and response for every route.

API included from the Pro plan, at €29 excl. tax a month, no commitment. Free to start, no credit card.

What hand-made links cost you

Copy the address, build the UTM, shorten it, generate the QR code, download it, file it: count two minutes per link. For a 300-product catalogue, that is a full day, to be done again for every campaign. And one typo in a utm_campaign is enough to split your statistics in two.

A route for every action

What you do in the dashboard, the API does too, with the same rules and the same limits as your plan. A single POST /v1/links request creates the short link, its UTM, its end date and its dynamic QR code. To react when a link expires, add automatic webhook alerts; to create links from a conversation, use the official MCP server for Claude.

  • Short links: custom address, UTM, shared UTM templates, scheduling and maximum number of clicks
  • Dynamic QR codes: created with the link, with or without a logo, or from your templates
  • Pages and components: create, edit and duplicate a page, and add your blocks to it
  • Statistics: clicks per day, referrers, countries and devices, over 1 to 90 days or since creation

See pricing

An AI agent receives the request “Create the spring campaign link, newsletter UTM, ending March 31” and calls POST /v1/links with the address, the short address, the UTM, the end date and the QR code. The API answers 201 in 87 ms: tnlnk.fr/spring, scheduled until March 31, with its QR code. Around it, the token and its scopes, and the limit of 120 requests per minute.

Tokens under control

One token per workspace, with its scopes: read, write, delete. It only opens the workspace it was generated in, is stored encrypted on our side, and can be regenerated or revoked in one click. Every response shows the requests left in the minute (120 per token): your scripts know when to slow down.

See webhooks

The workspace switcher is open: Studio Martin is the active workspace, the cursor hovers Agence Nord, and Maison Olea waits below. Behind, two workspaces with separate content: 12 pages and 48 links for Agence Nord, 7 pages and 21 links for Maison Olea. Around it, workspaces are sealed, and a new one takes a click.

Hosted in France, ready for your clients

The API, your links and your visitors’ statistics stay on French servers. With the Business plan, each agency client has its own workspace and its own token: a misconfigured script for one never touches the other’s links. Errors come back as JSON, with a code and the field at fault.

A French application

The TinyLink infrastructure status card: website, app, database and short-link redirects, all online, all in France, at o2switch. Next to it, a glowing point on Clermont-Ferrand. Around it, HTTPS across the service, secrets encrypted with AES-256-GCM and data never sold or rented.

A 300-product catalogue, its links and QR codes in minutes

An online shop prepares its shelf labels. Its script walks through the catalogue and calls POST /v1/links for each product page: a short link named after the product, “store” UTM, QR code created in the same request. Less than three minutes later, at 120 requests a minute, the 300 QR codes are ready to print, and every scan shows up in the statistics, product by product.

Frequently asked questions

Which plan includes the API?

From the Pro plan, at €29 excl. tax a month, no commitment, with 5 environments. The Business plan, at €79 excl. tax a month, goes up to 25, each environment with its own token.

Which languages and tools can I use?

Anything that can send an HTTPS request with an Authorization header: Python, PHP, JavaScript, curl, and also the HTTP request module of Make, Zapier or n8n. Responses are JSON.

Is there a request limit?

120 requests a minute per token. Every response carries the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers; beyond that, the API returns 429 with the time to wait. Your plan’s limits (pages, links) apply just as in the dashboard.

Are my data and tokens safe?

Your data is hosted in France and the GDPR applies. Each token only opens its workspace, with the scopes you choose; it is encrypted on our side and can be revoked at any time. The token panel shows the date of the last call and the number of calls.

Links created by your tools, not by hand

Create your account, move to the Pro plan and generate your token in Library ▸ Integrations. Your first link through the API takes one request.