TinyVag API

Reduce unwieldy URLs to compact, shareable links — and measure how they perform. Whether you're self-conscious about your link length or just want to track your performance metrics, TinyVag has you covered. No judgment. Just results.

What You Can Build

• Custom URL shorteners — help your users feel better about their link length
• Rich social sharing cards with branded OG images — visual enhancement for any link
• Embeddable content previews — slide your content into any page
• Performance analytics dashboards — hard numbers on how your links measure up

Live Demo

See what you can build with the TinyVag API.

Card Types Overview

TinyVag supports multiple rich card types for different content. Each card type renders a custom preview when shared. Click the "Code" toggle on any card to see the API payload.

Quickstart

Shorten a link in one request. Takes your full-length URL and makes it compact.

Shorten a URL

# Make it tiny
curl -X POST https://api.vagibond.com/share \
  -H "Content-Type: application/json" \
  -d '{
    "app": "tiny",
    "type": "redirect",
    "url": "https://example.com/very/long/url?with=params&that=goes&on=and&on=forever"
  }'

Response

{
  "id": "abc123",
  "url": "https://vagibond.com/s/abc123"
}

That's it. Your link is now 4 characters. Is 4 enough? Trust us — it's plenty.

Authentication

Include your API key in the X-TinyVag-Key header with every request.

curl -H "X-TinyVag-Key: your-api-key" \
  https://api.vagibond.com/share

Rate Limits

Create Link

Create a new TinyVag link. Takes your full-length URL and makes it compact.

Request Body

Example: URL Redirect

const response = await fetch('https://api.vagibond.com/share', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    app: 'tiny',
    type: 'redirect',
    url: 'https://example.com/embarrassingly-long-url-that-you-dont-want-anyone-to-see'
  })
});

const { id, url } = await response.json();
console.log(`Your tiny link: ${url}`);
// → Your tiny link: https://vagibond.com/s/abc123

Rich Card Types

Create links with enhanced visual presentation. Rich cards render custom previews instead of redirecting — making your tiny link look impressive.

Example: Grunt Card

{
  "app": "gutter",
  "type": "grunt",
  "profile": {
    "name": "DumpsterDave",
    "handle": "dave",
    "avatar": "https://cdn.vagibond.com/..."
  },
  "text": "Just found a whole pizza in the recycling. Today is a good day.",
  "sentiment": "positive"
}

Get Link

Retrieve metadata for an existing link. See full details about your link's dimensions and performance.

Path Parameters

curl https://api.vagibond.com/share/abc123

Get Preview Image

Get the OG preview image for a link. Returns a PNG. Because looks matter.

<!-- Embed a preview image -->
<img src="https://api.vagibond.com/og?id=abc123" alt="Link preview" />

Get Stats Coming Soon

Get performance analytics for a link. Know exactly how you're doing.

Planned response fields:

JavaScript SDK

The fastest way to integrate TinyVag. One script tag, one function call.

<!-- Load the SDK -->
<script src="https://vagibond.com/lib/vagibond-share.js"></script>

<script>
  // Shorten a link in one quick call
  VagibondShare.open({
    app: 'tiny',
    type: 'redirect',
    url: 'https://example.com/embarrassingly-long-url'
  });
</script>

The SDK opens a themed share modal, creates the link via the API, and provides copy/share options — all in one call. Fits anywhere, every time.

Other Languages

Pricing

Plans for every size.

View Full Pricing →