# HALOWERK Keyword Clip Range Finder

> HALOWERK Keyword Clip Range Finder is a paid API for AI agents from medien.halowerk.com, paid per call via x402, $0.031/call, status unknown (last checked 2026-10-20).

Returns padded timestamp ranges (cue clips) around caller-specified literal keywords found in a transcript of a media file, using Deepgram for transcription.

## Facts

- Endpoint: POST https://medien.halowerk.com/v1/baumarkt/media/keyword-clip-ranges?utm_source=zero.xyz
- Price: $0.031/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-keyword-clip-range-finder-067bdd87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jYRYxEjQ-TwAk2qBvlkB2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-keyword-clip-range-finder-067bdd87 -d '<json body>'
```

Example prompt: Search the transcript package for the keywords 'Rabatt' and 'Aktion' in my Baumarkt media file and give me padded clip ranges with 3 seconds of padding on each side so I can cut those segments out for a highlight reel.

## When to prefer this

Choose this endpoint when you need deterministic, literal keyword search with padded timestamp windows from an existing transcript package — it does not perform acoustic VAD or speaker diarization, so it is best suited for simple keyword spotting tasks on pre-qualified media where you want precise clip boundaries rather than semantic or speaker-aware search.

## Known failure modes

- Keyword not found in transcript — returns empty clip list
- Transcript package request fails or is invalid — article fails before settlement
- Deepgram transcription service unavailable — upstream failure propagated
- Audio file inaccessible or unsupported format — processing error
- Invalid padding value or malformed keyword list — request validation error
- Payment settlement failure if base motor fails — transaction aborted

## How this service works

Propose padded cue clips around caller-specified literal keywords. Reuses exactly one existing qualified transcript-package request. Source audio leaves the server for the existing Deepgram processor; existing provider disclosure and cost/margin retained. Deterministic timestamps/text processing only; no acoustic VAD, speaker identity or specialist accuracy claims. Base motor quote plus0.001USDC; article fails before settlement if the motor fails.

## Output

A JSON response containing a list of cue clip ranges, each with start and end timestamps (in seconds) padded around each keyword match found in the transcript, along with the matched keyword text and its position within the transcript.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "source": {
   "type": "object",
   "oneOf": [
    {
     "required": [
      "url"
     ]
    },
    {
     "required": [
      "content_base64"
     ]
    }
   ],
   "properties": {
    "url": {
     "type": "string",
     "pattern": "^https?://",
     "maxLength": 2048
    },
    "filename": {
     "type": "string",
     "maxLength": 260
    },
    "content_base64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 4
    }
   },
   "additionalProperties": false
  },
  "language": {
   "enum": [
    "de",
    "en",
    "es",
    "fr",
    "it",
    "nl",
    "pt",
    "multi"
   ],
   "type": "string"
  },
  "literal_terms": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 100,
    "minLength": 1
   },
   "maxItems": 50,
   "minItems": 1,
   "uniqueItems": true
  },
  "duration_minutes": {
   "type": "integer",
   "maximum": 30,
   "minimum": 1
  },
  "confidence_threshold": {
   "type": "number",
   "maximum": 1,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-keyword-clip-range-finder-067bdd87/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from medien.halowerk.com](https://www.zero.xyz/host/medien.halowerk.com/llms.txt)