Docs/API Reference/Quests Endpoint

Quests Endpoint

List, start, track, and complete quests with the headless client or widget UI.

List quests

const quests = await client.getQuests();

Each quest includes media, rewards (tokenReward, optional giftReward), availability, and type (video, survey, etc.).

Start a quest

const session = await client.startQuest(questId);

Track engagement

await client.trackClick(questId);

Complete

Completion is handled inside QuestWidget / AdQuestWidget after video end or survey submit. Hosts listening to onComplete receive tokens awarded and related result payload.

Stats

const stats = await client.getQuestStats();

UI filters

In the quests/rewards layout, the list supports All (available) and Completed filters so users can reopen rewards and rewatch media.