Changelog

EzyInsights Detections API · openapi.yaml

2026-10-14: a site with a path matches the publishers under it

A change in behaviour for sites that have a path; nothing changes for a site on a whole host.

2026-10-12: usage reports refuse a read that is too large

A change in behaviour for very large reports; nothing else changes.

2026-10-09: how a text detection was matched

Additive: nothing changes or goes. Flat files (CSV, TSV) do not change.

2026-10-09: groups, pinned publishers and labels on sites

Additive: nothing changes or goes.

2026-10-08: a managed image feed, and a test prefix for managed feeds

Additive: nothing changes or goes.

2026-10-07: delivery files documented

Documentation only: nothing in the API changes.

2026-10-01: destinations and webhooks by code

Additive: nothing changes or goes.

2026-09-29: the wire story's headline

Additive: nothing changes or goes, so a client that ignores fields it does not know needs no change.

2026-09-29: 503 while the data store restarts

2026-09-25: one subscription per key, no accounts

A key belongs to one subscription and reads only its data; nothing in the API names an account. No customer held a key when this changed.

2026-09-25: Sites

Sites (phase 2): customer and tracking lists per subscription; customer and classification now filled on detections re-scored after a list exists; the filters customer= and classification= on /v1/detections follow in a later release.

Expect a burst of updates when a list first exists. From the time a subscription first has a Sites list, every detection of it that is re-scored changes from customer: null to a value and comes through the change stream as an updated event: for text, the detections of the last 8 days, and for images of the last 30 days, over a day or two. Older detections keep null, and a later change to the list does not re-send anything; it applies to detections found or re-scored after it.

2026-09-25: sources and usage reports

New endpoints (additive; v1 is unchanged):

v1, 2026-09-24

The first version of the EzyInsights Detections API.

Endpoints

The detection schema v1, for text (wire stories) and images (photos): identity and version, source (the agency's item), strength (score and band), article (the publisher article and publisher), and customer and classification, which are null in this version. Every field is listed in the reference and at GET /v1/schema/detection.

Limits: 120 requests a minute per key, and a daily row allowance per account.

Deprecation policy (proposed)

Adding endpoints, parameters or fields is not a breaking change: it is announced here and made in place, so clients should ignore fields they do not know. Renaming or removing anything, or changing what it means, is a breaking change: it will come as a new version (a new detection schema_version, or a new URL version), announced here with 12 months' notice, during which answers from the old version carry Deprecation and Sunset headers. This policy is still a proposal and will be confirmed here.