# TVbeat

> TVbeat is a London-based, Techstars-backed advertising technology company whose
> platform unifies linear television and streaming (CTV) advertising operations into one
> commercial engine — forecasting, planning, transacting, optimizing and measuring
> campaigns across audiences, yield and operations, in ratings, spots, impressions and
> outcomes.

This file was GENERATED by API Evangelist from the public TVbeat surface on 2026-08-12.
TVbeat does not serve an llms.txt of its own: https://tvbeat.com/llms.txt returns 404,
and https://docs.tvbeat.com/llms.txt returns a 200 HTML login shell (the SnazzyDocs
single-page app answers every path with the same page), which is not a document.

## What an agent needs to know first

- **There is no callable public API today.** TVbeat's own API reference names
  `https://api.tvbeat.com` as the API root. That hostname does not resolve in public DNS
  (NXDOMAIN on the system resolver, 1.1.1.1 and 8.8.8.8, checked 2026-08-12), and the
  reference itself was last modified 2017-05-23.
- **The current product documentation is credential-gated.** `https://docs.tvbeat.com`
  is a SnazzyDocs instance that returns a page titled "Login" for every path. Access
  requires customer credentials; there is no self-serve signup.
- **There is no pricing.** No pricing page, no tiers, no trial. The only commercial
  call-to-action on the site is "Request a demo" (mailto:info@tvbeat.com).
- **There is no OpenAPI, GraphQL, AsyncAPI, MCP server or A2A agent card** anywhere on
  TVbeat's public surface. All of these were probed and all missed.

## The documented API (historical, first-party)

TVbeat published a complete API reference in its own GitHub organization. It describes
an analytics API with three query-shaped operations over a dataset:

- `GET /{dataset}/dimensions` — list the dimensions available for breakdown, filtering
  and target audience.
- `POST /{dataset}/dimensions_search` — search the values of a Set or HugeSet dimension.
  HugeSet dimensions require a `search_string` of at least 2 characters.
- `POST /{dataset}/breakdown` — return TV metrics for a time span, broken down by one
  dimension, constrained by filters.

Authentication is `TVBEAT-HMAC-SHA256`, a per-request HMAC-SHA256 signature scheme
modelled on AWS Signature Version 4: sign a canonical request with a key derived from
`HMAC("TVBEAT" + secret, timestamp)` then `HMAC(key_date, "ae")`, and send it in an
`Authorization` header alongside an `x-tvbeat-date` UNIX timestamp. Access key IDs and
secrets are assigned by TVbeat when an account is opened.

Documented failures: `401` (request not signed correctly), `403` (dataset or dimension
outside the caller's permissions), `429` (rate limit — one concurrent query per
key/secret pair). No error envelope is published and no rate-limit headers are returned.

## Docs

- [TVbeat API reference](https://github.com/tvbeat/public/blob/master/docs/api.md): the
  complete first-party API specification — auth, signing, endpoints, JSON Schemas,
  example responses, errors, rate limits.
- [TVbeat Dashboard release notes](https://github.com/tvbeat/public/blob/master/docs/release-notes.md):
  dated product release log, Cycle 102 (March 2018) through 111.0.1. Not updated since
  January 2019.
- [TVbeat Dashboard updates](https://github.com/tvbeat/public/blob/master/docs/updates.md):
  narrative feature announcements (Audience Builder, Indexing).
- [Tutorials](https://github.com/tvbeat/public/blob/master/docs/tutorial.md): dashboard
  how-to guides.
- [Documentation portal](https://docs.tvbeat.com/): current product docs — login required.

## Company

- [Website](https://tvbeat.com/)
- [How we do it](https://tvbeat.com/how)
- [About](https://tvbeat.com/about)
- [Blog](https://blog.tvbeat.com/) — Tumblr; last post 2015.
- [GitHub organization](https://github.com/tvbeat) — 35 public repos, overwhelmingly
  forks of infrastructure tooling (nixpkgs, vector, consul, rust crates). The only
  first-party product content is the `public` documentation repo.
- [Terms of Use](https://tvbeat-legal.snazzydocs.com/1.0/terms-of-use)
- [Privacy Policy](https://tvbeat-legal.snazzydocs.com/1.0/privacy-policy)

## Optional

- No SDKs or client libraries exist. npm, PyPI, RubyGems, crates.io, Packagist and
  NuGet were all searched on 2026-08-12 and returned zero packages for "tvbeat".
- No CLI, no sandbox, no test credentials, no Postman collection.
- No status page. `status.tvbeat.com` is a dangling Atlassian Statuspage CNAME that
  redirects to atlassian.com's own marketing site.