---
title: "Search TV programs"
method: GET
path: "/api/v1/search"
---

# Search TV programs

`GET /api/v1/search`

## Request

- Base URL: `https://tv.madeinro.eu`
- URL: `https://tv.madeinro.eu/api/v1/search`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`

Search programs across all Romanian TV channels by free text, channel, category and natural timeframe. Times are Europe/Bucharest.

## Query parameters

- `query` string: Free text to match against program title (case/diacritic-insensitive)
- `channel` string: Channel id, display name, or alias (e.g. "PRO TV", "tv-pro-tv", "HBO")
- `category` string: Channel category: Generaliste | Știri | Sport | Filme & Seriale | Documentare | Copii | Muzică | Altele
- `timeframe` string: Natural time reference: now | tonight | tomorrow | weekend | primetime | today | YYYY-MM-DD | ISO instant | ISO range "A/B"
- `exclude_news` boolean
- `limit` integer

## Response `200`

Matching programs.

- SearchResponse: Search result. Mirrors the MCP tv_search_program output shape.
  - `generated_at` string
  - `asked_at_utc` string, required
  - `timeframe_label` string
  - `window` object
    - `from_utc` string
    - `to_utc` string
  - `count` number, required
  - `items` object[], required
    - `channel_id` string, required
    - `channel_name` string, required
    - `channel_category` string
    - `program` object, required
      - `title` string, required
      - `start_local` string: Europe/Bucharest local time.
      - `start_utc` string, required
      - `stop_local` string
      - `stop_utc` string, required
      - `duration_min` number
      - `category` string
      - `description` string
    - `match_reason` string

---

[API](https://skmtc.dev/madeinro/apis/rotv-guide-api.md) · [All operations](https://skmtc.dev/madeinro/apis/rotv-guide-api/llms.txt) · [OpenAPI document](https://skmtc.dev/madeinro/apis/rotv-guide-api/revisions/7771a3ee9257?raw)