Developer Resources

Keynou Drive API Documentation

A comprehensive REST API for creating, managing, and tracking branded short links programmatically. Build custom integrations, automate link creation, and access real-time analytics - all with secure token authentication.

<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.

1

Create an Account

Sign up for a Keynou Drive account at drive.keynou.com/signup. All plans include API access.

2

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.

3

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.

4

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

Full Coverage

API Capabilities

The Keynou Drive API covers every feature of the platform. Manage links, analytics, domains, billing, branding, and more - all programmatically.

FeatureDescription
Link ManagementCreate, list, update, delete, and bulk-delete short links
AnalyticsSummary, dashboard stats, countries, cities, referrers, devices, OS
Custom DomainsList, create, verify, retry SSL, set primary, delete domains
Tenant BrandingGet and update brand name, colors, and logo
BillingList plans, create Polar.sh checkout sessions
Affiliate ProgramDashboard, link, stats, referrals, commissions, payouts
Account ManagementLogin, register, profile, email verification, password reset
Public ResolveResolve 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.

Interactive Documentation

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/