Clamor DataAPI reference

Introduction

Clamor Data API

Structured data on what the public says, watches and endorses in short video: one labelled record per video, and aggregates by entity, topic, region and day.

Every record carries the entities a video talks about and the position it takes toward each, its reach, and how the audience responds in the comments. Records use Clamor's own opaque ids; platform ids and author identities are never returned.

Base URL: https://clamordata.com/api/v1. All responses are JSON over HTTPS, and every response carries the release it was computed from.

Quickstart

  1. Create an account: a new account starts with a free 24-hour day pass (1,000 requests).
  2. Create a key under Account → API keys. It starts with clm_ and is shown once.
  3. Send it as Authorization: Bearer clm_… on every request.
AuthenticationKeys, the day pass and activation.Rate limits and quota10 requests a second, a monthly quota, the headers.List recordsPer-video records with filters and a cursor.Entity time seriesStance and volume by day, weighted by videos, views or likes.The recordEvery field of a per-video record.ErrorsStatus codes and error codes.
Your first request
curl -sS -G "https://clamordata.com/api/v1/records" \
  -H "Authorization: Bearer $CLAMOR_API_KEY" \
  --data-urlencode "category=economy" \
  --data-urlencode "min_salience=2" \
  --data-urlencode "limit=1"