For developers & AI agents

Your next link.
One API call away.

Shorten a URL. Generate a QR code. Let your agent handle the busywork, while every result stays in your LinkDirect workspace.

REST + MCP · Scoped keys · Start on Free

Create a short linkPOST /api/v1/links
{
  "destinationUrl": "https://example.com/offer",
  "title": "My next campaign",
  "utm": {
    "source": "newsletter",
    "medium": "email"
  }
}

201 Created

A trackable link, ready to share.

Short links, without the tab switching

Keep campaign parameters intact and create links from your app, automation or AI conversation.

QR codes that stay connected

Generate dynamic website QR codes, download PNG or SVG and manage their destinations in the dashboard.

Your workspace. Your permissions.

Give each connection just the scopes it needs. Set an expiry, see its last use and revoke it whenever you want.

Keep your whole campaign moving.

Create links, update their destinations and see what is working — from your assistant or application.

  • Edit destinations, titles, UTM parameters and GEO rules without changing the short URL.
  • Ask for your 10 most-clicked Facebook links over the last 7 days, or inspect one link’s results.
  • Create or update up to 50 links in one atomic batch. If any item fails, the entire batch rolls back.
  • Choose an active owned domain by hostname. No UUID copying, guessed identifiers or silent fallback.

Writes require your confirmation and share your plan limits. Analytics needs analytics:read; domain discovery needs account:read. Refresh your client’s tools or reconnect to approve missing permissions. Existing connections are never upgraded automatically.

From account to first link.

  1. 1Create your account and verify your email. Start with your Free workspace.
  2. 2Open API & MCP, name your connection and choose its permissions.
  3. 3Save your key privately, then send your first request. Your new link appears in the dashboard.

Your first request

curl 'https://linkdirect.co/api/v1/links' \
  -H "Authorization: Bearer $LINKDIRECT_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: my-campaign-link-01' \
  --data '{"destinationUrl":"https://example.com"}'

Use a fresh idempotency key for each intended creation. Reuse it when retrying the same request.

Your AI tools. One connection standard.

Use LinkDirect from your preferred assistant or editor. Claude and ChatGPT support browser sign-in through their published OAuth clients. Claude Code, Codex, Cursor, VS Code and other compatible MCP clients can use private API keys.

ClaudeChatGPTCodexCursorGitHub Copilot

Choose your client in API & MCP for its connection steps, secret handling and copyable configuration. Client availability depends on its version and account settings.

Choose your setup

Streamable HTTP endpoint

https://linkdirect.co/mcp

OAuth + PKCE for supported browser clients · Private Bearer keys for API and MCP

  • create_short_link
  • create_qr_code
  • list_domains
  • get_account_limits
  • get_qr_code_image
  • list_short_links
  • list_qr_codes
  • get_short_link
  • get_qr_code
  • update_short_link
  • get_top_links
  • get_link_analytics
  • bulk_create_short_links
  • bulk_update_short_links

Use get_qr_code_image to retrieve a QR in your AI client. Disconnect OAuth apps or revoke keys independently in API & MCP. The same workspace permissions and limits apply.

Small API. Useful building blocks.

Base URL: https://linkdirect.co/api/v1

OpenAPI 3.1 schema
MethodEndpointWhat it doesPermission
GET/accountPlan, usage and limitsaccount:read
GET/domainsActive domains, IDs and custom-slug supportaccount:read
POST/linksCreate a short linklinks:write
GET/linksList your short linkslinks:read
GET/links/{id}Read a short linklinks:read
POST/qr-codesCreate a dynamic QR codeqr:write
GET/qr-codesList your QR codesqr:read
GET/qr-codes/{id}Read a QR codeqr:read
GET/qr-codes/{id}/imageDownload PNG or SVGqr:read
PATCH/links/{id}Edit a short linklinks:write
POST/links/batchCreate a batch of linkslinks:write
PATCH/links/batchUpdate selected campaign linkslinks:write
GET/analytics/linksRank links by clicksanalytics:read
GET/links/{id}/analyticsRead aggregate link analyticsanalytics:read

Short-link edits include GEO rules and sharing settings. V1 QR codes accept website URLs; QR styling stays in the dashboard. REST downloads also need Bearer authentication.

Start free. Grow when you need to.

API and dashboard resources share your plan’s allowance. There is no duplicate quota or separate API subscription. Check live usage with GET /account, then upgrade in Billing when you need more room.

Compare plans

Built for safe automation

  • 24-hour safe retries. Same idempotency key and input return the original result, not a duplicate.
  • Clear limits. Free: 60 requests/minute and 10 creations/day, within your resource slots. Paid plans raise API budgets.
  • Actionable errors. Respect Retry-After on 429. A plan-limit response links to Billing; your agent never upgrades on its own.

Ready to connect?

Create a scoped key and give your workflow a shorter path.

Get your API key

Need error codes, retry rules or MCP setup details? Read the complete Markdown guide (English).