Authentication

​

API Token

After signing up, you’ll receive your PROBE_API_TOKEN. This token identifies your account and provides access to the API.

​

Authentication Methods

Choose the method that works best for your use case:

​

Header Authentication (Recommended)

Include your token in the Authorization header:

curl -H "Authorization: Bearer $PROBE_API_TOKEN" \
  "https://api.probe.dev/v1/probe/file?url=https://example.com/video.mp4&only=ffprobe"

Benefits:

• Keeps secrets out of URLs and server logs
• More secure than query parameters
• Standard HTTP authentication method

​

Query Parameter Authentication

Include your token as a query parameter:

curl "https://api.probe.dev/v1/probe/file?token=$PROBE_API_TOKEN&url=https://example.com/video.mp4&only=ffprobe"

Use cases:

• Quick testing with cURL
• Simple integrations
• When headers are difficult to set

​

Getting Your API Token

1. Sign up at probe.dev/dashboard
2. Verify your email address
3. Access your dashboard to view your API token
4. Copy your API token for use in requests

​

Rate Limits & Usage

Your API usage is tracked per token. Monitor your usage in the dashboard to see:

• Request count - Total API calls made
• Processing time - Cumulative analysis time
• Data processed - Total media data analyzed
• Queue metrics - Current processing status

​

Security Best Practices

​

Next Steps