<50ms
Avg response time
12+
REST endpoints
TLS 1.3
Encryption
5,000/min
Max rate limit
API Capabilities
Everything you need to manage links at scale
The Keynou Drive API provides full programmatic access to every feature of our branded URL shortening platform - from link creation to analytics to custom domain management.
RESTful Design
Clean, predictable REST endpoints following industry conventions. Every resource has a logical URL structure with standard HTTP methods.
API Key Auth
Generate API keys from your dashboard and authenticate via the X-API-Key header. Session-based auth also supported for dashboard workflows.
High Performance
Redis-backed infrastructure delivers sub-millisecond redirect resolution. PostgreSQL ensures durable, consistent data storage.
Secure by Default
CORS-restricted origins, credential-based session auth for the dashboard, and scoped API keys for programmatic access.
Comprehensive Resources
Manage short links, custom domains, analytics, billing, affiliate program, and tenant branding - all via API.
Analytics Access
Pull click analytics, geographic breakdowns, device data, referrer stats, and dashboard metrics programmatically.
Getting Started
Authentication & Authorization
The Keynou Drive API uses API key authentication. Follow these steps to get started with your first API request.
Create an Account
Sign up for a Keynou Drive account at drive.keynou.com/signup. All plans include API access.
Generate an API Key
Navigate to Dashboard > API Keys in your dashboard and click 'Generate New Key'. Give it a name and your key will be shown once - store it securely.
Authenticate Requests
Include your API key in the X-API-Key header for every API request: X-API-Key: kd_your_key_here. Alternatively, use Authorization: Bearer kd_your_key_here.
Start Building
Use the key to create links, fetch analytics, manage domains, and integrate Keynou Drive into your workflow.
Authentication Header Example
X-API-Key: YOUR_API_KEY Content-Type: application/json
Explore the API
Interactive API Reference
Browse the full OpenAPI specification, inspect request/response schemas, and test endpoints directly from your browser. Choose between our interactive Swagger UI or the clean ReDoc reference.
Swagger UI
Interactive API documentation where you can browse every endpoint, inspect schemas, and test API calls directly from your browser with live authentication.
Open Swagger UIReDoc
A clean, three-panel documentation reference generated from our OpenAPI schema. Perfect for reading through the full API specification with detailed examples.
Open ReDocFull Coverage
API Capabilities
The Keynou Drive API covers every feature of the platform. Manage links, analytics, domains, billing, branding, and more - all programmatically.
| Feature | Description |
|---|---|
| Link Management | Create, list, update, delete, and bulk-delete short links |
| Analytics | Summary, dashboard stats, countries, cities, referrers, devices, OS |
| Custom Domains | List, create, verify, retry SSL, set primary, delete domains |
| Tenant Branding | Get and update brand name, colors, and logo |
| Billing | List plans, create Polar.sh checkout sessions |
| Affiliate Program | Dashboard, link, stats, referrals, commissions, payouts |
| Account Management | Login, register, profile, email verification, password reset |
| Public Resolve | Resolve short codes and redirect without authentication |
What You Can Build
Popular API Use Cases
Bulk Link Creation
Generate thousands of branded short links from a CSV or database export. Perfect for migration from other platforms or campaign launches.
Analytics Dashboards
Pull click analytics into your own BI tools. Build custom dashboards with geographic breakdowns, referrer analysis, and device data.
Custom Shortener UI
Build your own branded link management interface on top of the Keynou Drive API. Full white-label capability for agencies.
SaaS Integration
Embed branded short links directly into your SaaS product. Let your users create custom-branded links without leaving your platform.
Marketing Automation
Auto-generate tracking links for email campaigns, social posts, and ad creatives. Tag links with UTM parameters via API.
Domain Management
Programmatically add, verify, and manage custom domains. Automate SSL provisioning and domain lifecycle via API.
Common Questions
API FAQ
How do I get an API key for Keynou Drive?
After creating an account, go to Dashboard > API Keys in your dashboard and click 'Generate New Key'. Give your key a name (e.g., 'Production App') and your API key will be displayed once - make sure to copy and store it securely. All plans, including the free tier, include API access.
What authentication method does the Keynou Drive API use?
The API supports two authentication methods: API key authentication via the X-API-Key header (for programmatic access) and session-based authentication (for dashboard workflows). For API requests, include your key in the X-API-Key header: X-API-Key: kd_your_api_key. You can also use Authorization: Bearer kd_your_api_key. You can manage and revoke API keys from the dashboard at any time.
Is the Keynou Drive API free to use?
Yes, the API is available on all plans including the free tier. The free tier includes 2 links and full API access. Paid plans offer higher link limits, custom domains, and advanced analytics.
Can I create branded short links with custom domains via the API?
Yes. First, add and verify a custom domain via POST /api/tenants/domains/. Then create short links using POST /api/drive/links/ with the destination URL. Your links will use your verified custom domain automatically.
What analytics data can I access via the API?
The API provides comprehensive analytics: summary stats (GET /api/analytics/summary/), dashboard metrics (GET /api/analytics/dashboard/), geographic breakdowns by country and city, referrer data, device types, and operating system stats.
What response format does the API use?
The Keynou Drive API returns JSON for all responses. Request bodies should be sent as JSON with the Content-Type: application/json header. All responses are wrapped in a consistent envelope with 'message' and 'data' fields.
Can I manage multiple API keys?
Yes. You can create multiple named API keys from the dashboard (e.g., one for production, one for development). Each key can be independently revoked at any time. Keys are prefixed with 'kd_' for easy identification.
Is the API documentation interactive?
Yes, our interactive API documentation includes a built-in Swagger UI where you can browse every endpoint, inspect request/response schemas, and test API calls directly from your browser. We also provide a clean ReDoc reference for reading the full OpenAPI specification. Both are linked on our API docs page.
Can I manage billing and subscriptions via the API?
Yes. Use GET /api/drive/billing/plans/ to list available plans and POST /api/drive/billing/checkout/ to create a Polar.sh checkout session for upgrading your subscription.
Does the API support bulk operations?
Yes. You can bulk-delete multiple links in a single request using POST /api/drive/links/bulk-delete/ by providing an array of link IDs.
Learn More
Additional Resources
Ready to explore the full API reference?
Our interactive Swagger UI lets you browse every endpoint, inspect request/response schemas, and test API calls directly from your browser. Authenticate with your token and start building in minutes.
Interactive docs at https://driveapi.keynou.com/api/docs and ReDoc at https://driveapi.keynou.com/api/redoc/