List alerts

GET/api/v1/alerts

Your matches, newest first, in the same shape as the webhook payload. Cursor pagination: pass next_cursor back as `after` to get the next page. The window is the last 90 days. Matches past the daily cap are never stored, so what you see here is exactly what was delivered.

Request

Query parameters

sincestring

ISO 8601 timestamp. Only alerts created after it.

keyword_idstring

Only this keyword.

typestring

post or comment.

subredditstring

Only this subreddit (with or without r/).

afterstring

The next_cursor from a previous page.

limitnumber

1 to 100 (default 50).

Response

Returns a JSON object with a data field containing the result.

Response fields

data[]array

Alerts. See Webhook payload for the fields.

next_cursorstring | null

Pass as `after` to continue. null on the last page.

curl -H "Authorization: Bearer rsp_your_key" \
"https://redship.io/api/v1/alerts?type=post&limit=20"

Success response200

{
"data": [
  {
    "event": "post",
    "timestamp": "2026-08-26T09:41:12.481932+00:00",
    "inbox_id": "c0a8…",
    "id": "1n3x9kq",
    "subreddit": "productivity",
    "author": "throwaway_pm",
    "url": "https://www.reddit.com/r/productivity/comments/1n3x9kq/…",
    "keyword": "notion alternative",
    "keyword_id": "5b2c…",
    "relevance_score": null,
    "created_utc": 1756201272,
    "title": "Looking for a Notion alternative for a small team",
    "selftext": "We are five people and Notion got slow…",
    "upvotes": 3,
    "replies": 0
  }
],
"next_cursor": "MjAyNi0wOC0yNlQwOTo0MToxMi40ODE5MzIrMDA6MDB8YzBhOC…"
}

For a polling loop, keep the newest timestamp you have seen and pass it as since on the next run. Rate limit: 60 requests per minute per key.