Skip to main content

Authentication

All Seaavey API endpoints require authentication via an API key. This page explains how to get a key and use it in your requests.

Getting Your API Key

  1. Sign up or log in at seaavey.com
  2. Navigate to API Keys in your dashboard
  3. Click Create New Key and give it a name
  4. Copy the key immediately — it won't be shown again

Using Your Key

Include your API key in the x-api-key header with every request:

curl -X GET "https://api.seaavey.com/downloader/tiktok?url=..." \
  -H "x-api-key: sk_live_abc123..."

Header Format

x-api-key: YOUR_API_KEY

The key must be sent as a request header. Query parameter authentication is not supported.

Key Management

  • You can create multiple keys for different projects
  • Set one key as default for the playground
  • Revoke compromised keys instantly from the dashboard
  • Keys can have optional expiration dates

Authentication Errors

If your key is missing, invalid, or expired, you'll receive:

{
  "status": 401,
  "success": false,
  "message": "Invalid or expired API key"
}

Security Tips

  • Never expose your API key in client-side code or public repositories
  • Use environment variables to store keys
  • Rotate keys periodically
  • Revoke keys you no longer use
  • Use separate keys for development and production