input | string | object | Input The website or sitemap URL this record belongs to, as given. |
recordType | string | Record type sitemap-url = one page URL (charged); summary = one record per input (never charged). e.g. "sitemap-url" |
position | integer | Position sitemap-url: 1-based position among the URLs delivered for its input. |
siteUrl | string | null | Site sitemap-url: the input normalized to an absolute URL. |
loc | string | null | URL The page URL (sitemap <loc>). |
lastmod | string | null | Last modified ISO 8601 (UTC) of the sitemap's <lastmod>; null when missing or not a valid date. |
changefreq | string | null | Change frequency always | hourly | daily | weekly | monthly | yearly | never, as declared. |
priority | number | null | Priority 0.0–1.0 as declared. |
sitemap | string | null | Sitemap The sitemap file the URL was listed in. |
images | array | Images Image extension: [{ loc, title, caption }]. |
news | object | null | News News extension: { publicationName, language, publicationDate, title, keywords }. |
videos | array | Videos Video extension: [{ title, description, thumbnailLoc, contentLoc, playerLoc, durationSecs, publicationDate, tags }]. |
alternates | array | Language alternates hreflang alternates: [{ hreflang, href }]. |
inputUrl | string | null | Input URL summary: the input normalized to an absolute URL. |
discoveredVia | string | null | Discovered via summary: input (a sitemap URL was given) | robots (robots.txt Sitemap: lines) | probe (/sitemap.xml or /sitemap_index.xml). |
sitemapsRead | integer | null | Sitemaps read summary: sitemap files fetched and read, indexes included. |
sitemapsFailed | integer | null | Sitemaps failed summary: sitemap files that could not be fetched or read (see warnings). |
sitemapsSkipped | integer | null | Sitemaps skipped summary: child sitemaps not read because of maxDepth, maxSitemaps or lastmodSince. |
duplicateUrls | integer | null | Duplicate URLs summary: URLs listed more than once (delivered once, never charged twice). |
excludedByPattern | integer | null | Excluded by pattern summary: URLs dropped by includePatterns / excludePatterns. |
olderThanLastmodSince | integer | null | Older than lastmodSince summary: URLs whose lastmod is before lastmodSince. |
resultsDelivered | integer | null | URLs delivered summary: sitemap-url rows delivered (and charged) for this input. |
stopReason | string | null | Stop reason summary: limit (maxUrlsPerSite reached) | end (all sitemaps read) | budget | free_plan | deadline | aborted | error. |
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 sitemap-url row (one sitemap-url event each); summary records are never charged. |
chargedEvent | string | Charged event sitemap-url on URL rows. |
chargedCount | integer | Events charged Events actually charged when a charge came back short (present only then). |
source | string | Source Always "sitemap" (fetched from the site by the Actor). |
fetchedAt | string | Fetched at ISO timestamp. |
error | object | Error { code, message, provider?, status? } when status is not ok. Codes: not_a_sitemap (no sitemap found or not a sitemap), invalid_url, not_found, http_error, timeout, network, dns_not_found, blocked_url, too_large, unexpected_type, invalid_body, 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 (sitemaps skipped or cut off, URLs without lastmod, caps). |