Table of Contents

Search and Relay APIs

Beyond Main, TorBoxSDK exposes two dedicated API families through the root client.

Search API

Access via ISearchApiClient (client.Search).

Typical scenarios:

  • torrent search and detailed torrent retrieval
  • Usenet search and NZB retrieval
  • metadata search
  • Torznab and Newznab style XML search
TorBoxResponse<TorrentSearchResponse> searchResults =
    await client.Search.SearchTorrentsAsync("ubuntu", cancellationToken: cancellationToken);

Relay API

Access via IRelayApiClient (client.Relay).

Typical scenarios:

  • relay service status checks
  • inactivity checks for relay links
TorBoxResponse<RelayStatus> status =
    await client.Relay.GetStatusAsync(cancellationToken: cancellationToken);

Separation rationale

  • Search and Relay have distinct hosts and semantics.
  • Consumers can reason about each API family independently.
  • The root client remains simple while preserving explicit boundaries.