API Quick Start Guide

Navigate to your ShadowPhone Dashboard > Settings > API Keys. Click 'Generate New Key'. Copy the key and store it securely -- it will only be shown once.

All API requests require a Bearer token. Include your API key in the Authorization header: 'Authorization: Bearer YOUR_API_KEY'. All requests must be made over HTTPS.

Try listing your accounts:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.shadowphone.com/v1/accounts

You should see a JSON response with your connected Instagram accounts.

The API is rate-limited to 100 requests per minute per key. If you exceed this, you will receive a 429 response. Use exponential backoff for retries.

All errors return a JSON object with 'error' (code) and 'message' (human-readable description). Common errors: 401 (invalid key), 403 (insufficient permissions), 429 (rate limited), 500 (server error).