alerts

List the events the daily run detected

Lists the alert events the pipeline recorded for the workspace in the last 30 days, newest first, whether or not any webhook or email alert is subscribed. Each item carries the event, the time it was recorded, the app, the market, one plain sentence and the typed payload. review.new and digest.weekly are never listed, and a drop or exit repeated for subscribers that wait for confirmation is listed once. type takes one or more feed events, comma separated or repeated. appId includes the app’s competitors and the search result entrants of the keywords it tracks. since is an ISO 8601 date or instant and is exclusive. Page with nextCursor, which is null on the last page. Answers 400 for an unknown type, a bad since, cursor or limit, and 404 for an app that is not in the workspace.

GET

alerts

events

curl --request GET \
  --url http://localhost:3000/api/backend/alerts/events \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://localhost:3000/api/backend/alerts/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

type

enum<string>[]

Available options:

metadata.changed,

rank.dropped,

rank.improved,

rank.milestone,

rank.first,

rank.overtaken,

review.negative,

serp.entrant,

action.opened,

chart.entered,

chart.left,

chart.milestone,

rating.dropped,

review.spike,

app.delisted,

app.unlisted_market

appId

string

Maximum string length: 64

since

string

Example:

"2026-11-01T00:00:00.000Z"

cursor

string

Maximum string length: 200

limit

number

default:50

Required range: 1 <= x <= 100

Response

200 - application/json

The response is of type object.

List the events the daily run detected

curl --request GET \
  --url http://localhost:3000/api/backend/alerts/events \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://localhost:3000/api/backend/alerts/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

Overview

Endpoints

List the events the daily run detected

Authorizations

Query Parameters

Response