input | string | object | Input
The feed, website or newsletter URL this record belongs to, as given. |
recordType | string | Record type
feed-item = one item of a feed (charged); summary = one record per input URL (never charged). e.g. "feed-item" |
position | integer | Position
feed-item: 1-based position of the item among the items delivered for its input (newest first). |
feedUrl | string | null | Feed URL
The feed the item was read from (after redirects). |
feedTitle | string | null | Feed title |
guid | string | null | GUID
The item's id in the feed (RSS guid, Atom id, JSON Feed id), else its link. |
title | string | null | Title
Item title as plain text (markup and entities decoded). |
link | string | null | Link
Absolute URL of the item's page. |
publishedAt | string | null | Published at
ISO 8601 (UTC) publication time; null when the feed gives no valid date. |
updatedAt | string | null | Updated at
ISO 8601 (UTC) last update, when the feed states one (Atom updated, JSON Feed date_modified). |
author | string | null | Author
Author or creator name as published. |
summary | string | null | Summary
Plain-text summary (description / summary, else the start of the content), at most 1,000 characters. |
contentHtml | string | null | Content (HTML)
Full content as published in HTML (content:encoded, Atom content, content_html), at most 100,000 characters; only with includeContent. |
contentText | string | null | Content (text)
Full content as plain text (content_text, else derived from contentHtml), at most 100,000 characters; only with includeContent. |
categories | array | Categories
Categories and tags of the item. |
enclosure | object | null | Enclosure
{ url, type, length } of the item's first enclosure (podcast audio, video, attachment). |
imageUrl | string | null | Image URL
Media thumbnail, iTunes image, image enclosure or the first image of the content. |
durationSecs | integer | null | Duration (s)
Media duration in seconds (podcasts, videos), when stated. |
inputUrl | string | null | Input URL
summary: the input normalized to an absolute URL. |
feedFormat | string | null | Feed format
summary: rss | atom | rdf | json. |
siteUrl | string | null | Site URL
summary: the website the feed belongs to. |
feedDescription | string | null | Feed description |
feedLanguage | string | null | Feed language |
feedImageUrl | string | null | Feed image URL |
feedUpdatedAt | string | null | Feed updated at
summary: ISO 8601 time the feed says it was last built or updated. |
discoveredVia | string | null | Discovered via
summary: direct (the URL is a feed) | platform (Substack, Medium, …) | link (<link rel="alternate"> on the page) | probe (a common feed path). |
platform | string | null | Platform
summary: substack | medium | ghost | beehiiv | wordpress | blogger | tumblr | youtube, when recognised. |
otherFeeds | array | Other feeds
summary: further feeds the page announces (e.g. a comments feed). |
itemsInFeed | integer | null | Items in feed
summary: items the feed lists. |
itemsOutsideDateWindow | integer | null | Items outside sinceDays
summary: items older than sinceDays (not delivered, not charged). |
onlyNew | boolean | null | Only new
summary: present when onlyNew was on. |
firstRun | boolean | null | First run
summary (onlyNew): true when no earlier run remembered this feed. |
itemsAlreadySeen | integer | null | Items already seen
summary (onlyNew): items skipped because an earlier run delivered them. |
resultsDelivered | integer | null | Items delivered
summary: feed-item rows delivered (and charged) for this input. |
stopReason | string | null | Stop reason
summary: limit (maxItemsPerFeed reached) | end (no more items) | budget | free_plan | aborted. |
status | string | Status
ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan | skipped_unmetered e.g. "ok" |
charged | boolean | Charged
true on every feed-item row (one feed-item event each); summary records are never charged. |
chargedEvent | string | Charged event
feed-item on item rows. |
chargedCount | integer | Events charged
Events actually charged when a charge came back short (present only then). |
source | string | Source
Always "feed" (fetched from the publisher by the Actor). |
fetchedAt | string | Fetched at
ISO timestamp. |
error | object | Error
{ code, message, provider?, status? } when status is not ok. Codes: not_a_feed (no feed found), malformed_feed, invalid_url, not_found, http_error, timeout, network, dns_not_found, blocked_url, too_large, unexpected_type, plus the runtime codes budget_exhausted, free_plan_limit, unmetered, aborted, charge_failed, record_too_large, invalid_record, dataset_push_failed. |
warnings | array | Warnings
Notes about this record (lenient parsing, undated items, budget or free-plan caps). |
raw | object | null | Raw item
The parsed source item with every namespace (only with includeRaw). |