SnipyDevelopers
Changelog

API Changelog

Track new features, improvements, and breaking changes in the Snipy API. We follow semantic versioning and announce all changes here.

API versioning

The Snipy API is currently unversioned -- all endpoints are accessed at https://api.snipy.com/api/*. When we introduce breaking changes, we will version the API and maintain backward compatibility for at least 6 months.

Base URL
https://api.snipy.com/api/
feature

v2.0 -- Full API Launch

  • 150+ endpoints across Links, QR Codes, Bio Profiles, Analytics, Domains, Campaigns, Webhooks, and Account management
  • A/B testing endpoints: POST /api/url/:id/variants for link variant management
  • Campaign statistics: GET /api/campaign/:id/stats for aggregated campaign analytics
  • Pay-per-view links: ppvPrice field on link creation with Stripe Checkout
  • Snipy Drops: maxClicks field for click-limited link expiration
  • AI bio builder: POST /api/bio/:id/ai-generate for AI-powered bio content
  • Teams plan gating: checkPlanFeature and checkPlanLimit enforcement on all endpoints
feature

Creator Store API & Digital Products

  • Added Digital Products CRUD: POST/GET/PUT/DELETE /api/products
  • Added Tip Jar integration via Stripe Connect with 5% platform fee
  • Added email subscriber collection through bio newsletter blocks
  • Added GET /api/bio/:id/subscribers and CSV export endpoint
  • Added newsletter send endpoint: POST /api/newsletter/:id/send
feature

Webhooks System & Automations API

  • Added webhook subscription management: POST/GET/DELETE /api/webhooks/subscribe
  • 15 event types: link.created, link.clicked, link.updated, link.expired, qr.created, qr.scanned, bio.viewed, bio.updated, subscriber.added, plan.upgraded, product.created, product.purchased, tip.received, verification.approved, newsletter.sent
  • HMAC-SHA256 payload signing via X-Snipy-Signature header
  • Automatic retry with exponential backoff (5 attempts over 24 hours)
  • Added Zapier integration trigger endpoints
improvement

Deep Links & QR Bulk Generation

  • Added deepLinks JSONB field to link creation -- supports 25 app providers
  • Auto-detection for YouTube, Instagram, Twitter/X, TikTok, Spotify, Amazon, WhatsApp, Telegram, LinkedIn, Pinterest, Snapchat, Netflix
  • Added bulk QR code generation: POST /api/qr/bulk
  • Added artistic AI QR codes: POST /api/qr/:id/artistic
  • Added server-side QR download: GET /api/qr/:id/download with PNG, SVG, PDF formats
improvement

Import/Export API

  • Added CSV import for bulk link creation
  • Added CSV export for links and analytics data
  • Added bulk link operations: POST /api/urls/bulk (max 100 per request)
  • Added bio subscriber CSV export: GET /api/bio/:id/subscribers/export
feature

Initial API Release

  • Link management: create, read, update, delete shortened URLs
  • 30 premium domains across 3 tiers (Free, Starter+, Pro+)
  • Click analytics: geographic, device, browser, referrer, and time-series data
  • API key authentication with SHA-256 hashing and snpy_ prefix
  • OAuth 2.0 token exchange with refresh tokens and 2FA support
  • Rate limiting with X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After headers
  • Bio profile management: 16 endpoints with block-based content system
  • Custom domain management with DNS verification