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.

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 6 characters. Is 6 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 →