API & delivery

One record contract, three ways to take it.

Cursor pagination, ISO-8601 timestamps, versioned endpoints. Fields are added, never redefined.

Endpoints

Method	Path	Returns
GET	/v1/series	Aggregated series by region, topic and date range
GET	/v1/entities	Canonical entity list with aliases and identifiers
GET	/v1/records	Individual labeled records behind an aggregate
GET	/v1/coverage	Markets, cadence and history currently in production
GET	/v1/releases	Release notes, revisions and agreement rates

Request

curl -sS https://api.clamordata.com/v1/series \
  -H "Authorization: Bearer $CLAMOR_API_KEY" \
  -G \
  -d dataset=social-discourse-index \
  -d region=US-NY \
  -d topic=housing \
  -d from=2026-01-01 \
  -d to=2026-05-20

Response

{
  "dataset": "social-discourse-index",
  "unit": "region x topic x week",
  "next": null,
  "data": [
    {
      "date": "2026-05-18",
      "region": "US-NY",
      "topic": "housing",
      "sentiment": -0.42,
      "share": 0.031,
      "n": 431,
      "ci95": [-0.46, -0.38]
    }
  ]
}

Delivery

REST API

Query by region, topic, entity and date range. Cursor pagination, ISO-8601 timestamps, versioned endpoints and a stable record contract.

Bulk export

Parquet and CSV drops to S3, GCS or Azure on your cadence. Full historical backfill lands with the first delivery.

Custom slices

Bespoke taxonomies, entity lists and regional cuts built against a specific research question, delivered on the same schema.

Request a sample dataset.

Tell us the market and the question. We return a real slice — schema, sample sizes and confidence intervals included — not a brochure.

Request access Read the methodology