LinkVice REST API: Automate Your Redirect Management
LinkVice is not just a dashboard — it's a fully programmable redirect management platform. With our REST API, you can automate every aspect of your redirect workflow.
Full API Access
The LinkVice API gives you complete programmatic control over:
- Domains — Add, list, and remove custom domains
- Redirects — Create, update, delete, and configure redirects with all options (language rules, bot blocking, image redirects, favicon/robots.txt/ads.txt/llm.txt handling)
- Statistics — Pull click data, unique visitors, country/language breakdowns, and traffic flow analysis
- Blacklist — Manage IP blocks, User-Agent filters, and URI patterns
Authentication
Generate an API key in your Dashboard Settings. Use it as a Bearer token in every request:
Authorization: Bearer YOUR_API_KEY
Quick Example: Create a Redirect with PHP
<?php
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://www.linkvice.com/api/v1/redirects',
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'domain_id' => 1,
'target_url' => 'https://example.com/landing',
'redirect_type' => 'direct',
'http_code' => 301,
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
Official SDKs
We provide official SDK libraries for the most popular languages:
- PHP — github.com/linkvice/php-sdk —
composer require linkvice/php-sdk - Python — github.com/linkvice/python-sdk —
pip install linkvice - JavaScript/Node.js — github.com/linkvice/javascript-sdk —
npm install @linkvice/sdk
Rate Limiting
The API allows 100 requests per minute per API key. Response headers include X-RateLimit-Remaining so you can monitor your usage.
Use Cases
Marketing Automation
Automatically create campaign-specific redirects from your marketing platform. Pull stats back into your dashboard for reporting.
CI/CD Integration
Set up redirects as part of your deployment pipeline. When you deploy a new version, automatically update redirect targets.
Multi-Tenant Platforms
Build white-label redirect services on top of LinkVice. Each of your clients gets their own domains and redirects, managed through the API.
Full documentation with examples for every endpoint: API Documentation →