> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fastdrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Detect Clips

> Detect clip candidate timestamps without classification

Detect clip candidate timestamps with labels, explanations, and confidence scores. Useful for podcast highlights, interview moments, and social media cuts.

**Cost:** 2 credits

<ParamField body="video_url" type="string" required>
  Public HTTP/HTTPS URL of the video.
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional HTTPS URL to receive a POST when processing completes.
</ParamField>

### Response (202 Accepted)

Returns a job submission with `job_id`. Get the result from [Get Job Status](/api-reference/get-job-status) with `?wait=N`, or subscribe to `job.completed` via a [webhook](/guides/webhooks).

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.fastdrop.io/api/v1/clips \
    -H "Content-Type: application/json" \
    -H "X-API-Key: fd_live_your_key_here" \
    -d '{"video_url": "https://example.com/podcast-episode.mp4"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "status": "queued",
    "credits_charged": 2,
    "estimated_seconds": 60,
    "poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "created_at": "2026-03-05T12:00:00Z"
  }
  ```
</ResponseExample>

### Result format

When the job completes, the `results` field contains:

```json theme={null}
{
  "clips": [
    {
      "start_time": 5.2,
      "end_time": 25.8,
      "label": "Key discussion point",
      "explanation": "Sustained speech with clear topic boundaries",
      "confidence": 0.82
    },
    {
      "start_time": 45.0,
      "end_time": 72.3,
      "label": "Highlight moment",
      "explanation": "High-energy segment with natural pause boundaries",
      "confidence": 0.75
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.