TypeScript SDK

npm install @refmatter/sdk

import { Refmatter } from '@refmatter/sdk';

const refmatter = new Refmatter({ apiKey: process.env.REFMATTER_API_KEY! });

// URL in, reference out, as soon as metadata and transcript are readable.
const { ingestion, reference } = await refmatter.resolve(
  'https://www.youtube.com/watch?v=jNQXAC9IVRw',
  { onUpdate: (update) => console.log(update.state) },
);
if (reference === null) {
  throw new Error(`${ingestion.outcomeCode}: ${ingestion.outcomeMessage}`);
}

// Browse, annotate, keep the bytes longer, download.
const page = await refmatter.references.list({ limit: 20, platform: 'youtube' });
await refmatter.references.update(reference.id, {
  revision: reference.revision,
  tags: ['hook'],
});
await refmatter.references.setMediaHold(reference.id, 90);
const access = await refmatter.media.access(reference.primaryMediaId!);