Developers

Research Catalog API

Discover Wrivid’s public catalog of institutional research reports, publishers, dates, report types, and Wrivid-created summaries. The API is metadata-only.

Parameters

source accepts a publisher slug. timeframe accepts all or a trailing month value such as 24m. includeHistory removes the default 24-month window when no timeframe is supplied. limit is clamped to 200, offset is zero-based, and sort accepts newest, oldest, or alpha. Optional from and to bounds use YYYY-MM-DD.

Follow pagination.nextOffset until it is null. total is the exact number of visible reports matching the filters.

Response fields

id and slug: Stable report identifiers.
source: Publisher name and slug.
url and sourceUrl: Wrivid report page and original publisher link.
summary: Wrivid-created summary, when available.

JavaScript pagination

let offset = 0;
do {
  const url = new URL("https://wrivid.com/api/reports");
  url.search = new URLSearchParams({
    timeframe: "all", includeHistory: "true", limit: "200", offset: String(offset)
  });
  const { reports, pagination } = await fetch(url).then(r => r.json());
  reports.forEach(report => console.log(report.title, report.sourceUrl));
  offset = pagination.nextOffset;
} while (offset !== null);

curl pagination

offset=0
while :; do
  body=$(curl -fsS "https://wrivid.com/api/reports?timeframe=all&includeHistory=true&limit=200&offset=$offset")
  printf '%s\n' "$body"
  offset=$(printf '%s' "$body" | jq -r '.pagination.nextOffset')
  [ "$offset" = "null" ] && break
done

Attribution and source rights

Consumers should link to both the Wrivid report page and the original publisher source. API access does not grant rights to reproduce source documents, report text, or commercially redistribute publisher material. Raw documents, parsed text, private storage paths, ingestion data, internal statuses, and raw metadata are not returned.