Ready to get started? Sign up for free to get your API key and begin analyzing media files.

Minimal Request

The fastest way to get started is with a simple cURL request:

curl -G https://api.probe.dev/v1/probe/file \
  --data-urlencode "token=${PROBE_API_TOKEN}" \
  --data-urlencode "only=ffprobe" \
  --data-urlencode "url=https://probelibrary.s3.amazonaws.com/sample-source.mp4"

The response is standard JSON identical to what a local ffprobe run would return.

Authentication

MethodExampleNotes
Header (recommended)Authorization: Bearer $PROBE_API_TOKENKeeps secrets out of URLs & logs
Query string?token=$PROBE_API_TOKENHandy for quick cURL tests

After signing up, you’ll see your PROBE_API_TOKEN in your dashboard.

API Endpoint

https://api.probe.dev/v1/probe/file

We accept both GET and POST requests:

MethodParameters inUse when
GETQuery stringSmall payloads, quick tests
POSTBody (multipart/form-data,application/x-www-form-urlencoded, or application/json)Large payloads or many options

Provide the Media Asset

Specify a direct link to media file hosted on any webserver or within a publicly available S3 bucket. If you don’t have a media asset handy, check out our sample media library.

{
    "url": "https://probelibrary.s3.amazonaws.com/sample-source.mp4"
}

Alternative: Use with AI Assistants

Skip the manual API calls and integrate Probe.dev directly with your AI assistant:

Next Steps