Docs/API Reference/GET /v1/records

GET /v1/records

List records from your org's Dataset — posts ingested from your Watchers' channels. Cursor-paginated and org-scoped.

Request

All parameters are optional query-string values. Results are cursor-paginated.

curl "https://api.prowlo.com/v1/records?view=matched&limit=10" \
  --header "Authorization: Bearer prowlo_your_key"

Views: all vs matched

all returns every post from your watched channels. matched returns only posts that one of your Watcher’s prefilter rules matched — and unlocks the tags, read, and archived filters.

Parameters

Parameter	Type	Default	Description
view	all \| matched	all	all = every post from watched channels. matched = only posts a Watcher’s prefilter rules matched (enables tags/read/archived).
subreddits	string[]	—	Filter to one or more channel names (case-insensitive), e.g. SaaS,webdev.
platforms	string[]	—	Filter by platform. Currently reddit or hackernews.
tags	string[]	—	Filter by org-assigned record tags (applies to matched records).
watcher_id	string	—	Restrict to records from one specific Watcher (must belong to your org). An unknown id returns an empty result.
min_score	number	—	Minimum post score (net upvotes).
min_comments	number	—	Minimum comment count.
has_link	boolean	—	When true, only posts with an external link URL.
has_image	boolean	—	When true, only posts with an image URL (heuristic on the link).
from	string	—	Only records created on or after this ISO 8601 date.
to	string	—	Only records created on or before this ISO 8601 date.
limit	number	20	Results per page. Max 100.
cursor	string	—	Opaque cursor from a previous response’s nextCursor. Treat as opaque.
keyword	string	—	Case-insensitive substring match against title and body.
read	boolean	—	Filter by read state (matched view only).
archived	boolean	false	Filter by archived state (matched view only). Defaults to non-archived.
sort	firstSeenAt \| score \| numComments	firstSeenAt	Sort order, descending (matched view; all view always sorts newest-first).

Try itGET /v1/records

viewall = every post from watched channels. matched = only posts a Watcher’s prefilter rules matched (enables tags/read/archived).subredditsFilter to one or more channel names (case-insensitive), e.g. SaaS,webdev.platformsFilter by platform. Currently reddit or hackernews.tagsFilter by org-assigned record tags (applies to matched records).watcher_idRestrict to records from one specific Watcher (must belong to your org). An unknown id returns an empty result.min_scoreMinimum post score (net upvotes).min_commentsMinimum comment count.has_linkWhen true, only posts with an external link URL.has_imageWhen true, only posts with an image URL (heuristic on the link).fromOnly records created on or after this ISO 8601 date.toOnly records created on or before this ISO 8601 date.limitResults per page. Max 100.cursorOpaque cursor from a previous response’s nextCursor. Treat as opaque.keywordCase-insensitive substring match against title and body.readFilter by read state (matched view only).archivedFilter by archived state (matched view only). Defaults to non-archived.sortSort order, descending (matched view; all view always sorts newest-first).

curl "https://api.prowlo.com/v1/records" \
  --header "Authorization: Bearer $PROWLO_API_KEY"

Run uses your browser session against /api/v1/records with your key — identical parameters, just a same-origin host instead of api.prowlo.com.

Responsesample response

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "rec_01HXYZ123456",
        "platform": "reddit",
        "redditId": "1abc2de",
        "subreddit": "SaaS",
        "title": "Looking for a Reddit monitoring tool for our startup",
        "permalink": "https://www.reddit.com/r/SaaS/comments/1abc2de/looking_for_a_reddit_monitoring_tool/",
        "url": null,
        "score": 47,
        "numComments": 23,
        "redditCreatedAt": "2026-06-12T14:22:08.000Z",
        "author": "founder_pete",
        "hasLink": false,
        "tags": [
          "high-intent"
        ],
        "matched": true,
        "intent": "BUYING",
        "snippet": "We've been trying to find conversations about our space on Reddit but it's taking hours manually. Anyone know of a tool that…"
      }
    ],
    "nextCursor": "rec_01HABC789012"
  }
}

Response

data.items is an array of records; data.nextCursor is the cursor for the next page (or null on the last page).

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "rec_01HXYZ123456",
        "platform": "reddit",
        "redditId": "1abc2de",
        "subreddit": "SaaS",
        "title": "Looking for a Reddit monitoring tool for our startup",
        "permalink": "https://www.reddit.com/r/SaaS/comments/1abc2de/looking_for_a_reddit_monitoring_tool/",
        "url": null,
        "score": 47,
        "numComments": 23,
        "redditCreatedAt": "2026-06-12T14:22:08.000Z",
        "author": "founder_pete",
        "hasLink": false,
        "tags": [
          "high-intent"
        ],
        "matched": true,
        "intent": "BUYING",
        "snippet": "We've been trying to find conversations about our space on Reddit but it's taking hours manually. Anyone know of a tool that…"
      }
    ],
    "nextCursor": "rec_01HABC789012"
  }
}

A couple of field notes

score and numComments may be 0 for recently crawled posts until refreshed. redditId / subreddit are the post’s external id / channel (names kept for backwards compatibility across platforms). An empty Dataset returns { "items": [], "nextCursor": null }.

← GET /v1/me POST /v1/search →