{
"openapi": "3.0.1",
"info": {
"title": "RSS & Atom Feed Scraper: Universal Content Monitor",
"description": "Parse any RSS, Atom or JSON feed into a single normalised schema: title, link, author, published date, categories, media enclosures and full content. Auto-discovers the feed from a plain site URL.",
"version": "0.0",
"x-build-id": "baPIvWsFvAQRhwuak"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/arman-bd~rss-feed-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-arman-bd-rss-feed-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/arman-bd~rss-feed-scraper/runs": {
"post": {
"operationId": "runs-sync-arman-bd-rss-feed-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/arman-bd~rss-feed-scraper/run-sync": {
"post": {
"operationId": "run-sync-arman-bd-rss-feed-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"feedUrls"
],
"properties": {
"feedUrls": {
"title": "Feed or site URLs",
"type": "array",
"description": "Feed URLs to read. A site homepage works too: if the URL is not itself a feed, the page's tags are followed, and failing that the conventional paths (/feed, /rss.xml, /atom.xml, /index.xml) are tried. A URL that resolves to no readable feed is recorded in RUN_SUMMARY.failures and the run continues.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max items (whole run)",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "Total saved items for the entire run, applied after filtering and shared evenly across the sources, with a source that comes up short leaving its unused share to the others. This is a ceiling on what you are charged, not a per-feed allowance: 20 across five feeds saves 20 items, not 100. 0 means every item the feeds carry. Most feeds only publish their 10-50 most recent items anyway.",
"default": 0
},
"maxItemsPerFeed": {
"title": "Max items (former field name)",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "The earlier name of 'maxItems', accepted so existing calls keep working. It is applied as a run-wide total, exactly like 'maxItems'; set 'maxItems' instead."
},
"sinceDate": {
"title": "Published after",
"type": "string",
"description": "Keep only items published after this moment. Accepts a plain date ('2026-01-01') or a full ISO-8601 timestamp ('2026-01-01T00:00:00Z'). Items whose feed gives no publish date are never dropped by this filter. Leave empty for everything the feed carries."
},
"keywordFilter": {
"title": "Keyword filter",
"type": "array",
"description": "Keep only items whose title, summary or categories contain one of these terms (case-insensitive, OR-combined). Empty keeps everything. Matching happens on the summary, not the full body, so a term buried deep in an article will not match.",
"items": {
"type": "string"
}
},
"includeContent": {
"title": "Include full content",
"type": "boolean",
"description": "Include the full article body in 'contentText'. from on RSS, on Atom or 'content_html' on JSON Feed. Turn off for a much smaller dataset when you only need headlines and links.",
"default": true
},
"stripHtmlTags": {
"title": "Strip HTML to plain text",
"type": "boolean",
"description": "On (default), bodies are delivered as clean plain text and 'contentHtml' is null. Off, the publisher's original markup is kept in 'contentHtml' as well. useful if you need the images and links inside an article.",
"default": true
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}