{ "openapi": "3.0.1", "info": { "title": "Best Damn RSS to JSON Converter", "description": "Convert RSS, Atom and JSON Feed into clean, consistent JSON items: title, link, author, date, content, images and podcast enclosures. Paste a site URL and it finds the feed for you. Pay per item; failed feeds are free.", "version": "0.1", "x-build-id": "vv1fz36ey9CJPsdIo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/josh99smith~rss-feed-to-json/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-josh99smith-rss-feed-to-json", "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/josh99smith~rss-feed-to-json/runs": { "post": { "operationId": "runs-sync-josh99smith-rss-feed-to-json", "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/josh99smith~rss-feed-to-json/run-sync": { "post": { "operationId": "run-sync-josh99smith-rss-feed-to-json", "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 website URLs", "type": "array", "description": "One URL per line. RSS 2.0, Atom, RSS 1.0 (RDF) and JSON Feed URLs are parsed directly. If a URL is an ordinary web page, the Actor looks for the feed it advertises (`` and similar) and common paths such as `/feed` or `/rss.xml`. Duplicates are removed automatically.", "items": { "type": "string" } }, "maxItemsPerFeed": { "title": "Max items per feed", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Deliver at most this many items from each feed (newest first, in feed order).", "default": 100 }, "publishedAfter": { "title": "Published after", "pattern": "^\\s*$|^\\d{4}-\\d{2}-\\d{2}", "type": "string", "description": "Optional. Skip items published before this date. ISO 8601, e.g. `2026-01-31` or `2026-01-31T12:00:00Z`. Items without a publication date are kept." }, "includeContent": { "title": "Include full HTML content", "type": "boolean", "description": "Add the article body as HTML (`contentHtml`, capped at 50,000 characters). Switch off for a smaller dataset when you only need titles and links.", "default": true }, "plainText": { "title": "Add plain-text content", "type": "boolean", "description": "Strip HTML from the article body into `contentText` (capped at 5,000 characters). Handy for search indexes, LLM prompts and spreadsheets.", "default": true }, "onlyNew": { "title": "Only new items since the last run", "type": "boolean", "description": "Monitor mode. The ids of every item delivered are remembered in a named key-value store, so scheduled runs return only items not seen before. The first run returns everything; later runs return only new posts. Items filtered out as already seen are never billed. Every record also carries an `isNew` flag, whether or not this is on.", "default": false }, "timeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Give up on a feed after this many seconds.", "default": 30 }, "stateStoreName": { "title": "State store name", "pattern": "^$|^[a-zA-Z0-9][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$", "type": "string", "description": "Name of the key-value store that remembers seen item ids for **Only new items since the last run**. Leave empty for the automatic name `rss-feed-to-json-seen`. Use different names to keep separate watchlists (e.g. one per group of feeds). Letters, digits and dashes only.", "default": "" }, "seenTtlDays": { "title": "Forget seen items after (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Ids not seen in any run for this many days are dropped from the state store, which keeps it small. An item that reappears after that is reported as new again. Use 0 to keep ids forever (up to 100,000 ids, oldest dropped first).", "default": 90 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Route requests through Apify Proxy if a site blocks cloud IP addresses. Proxy usage is billed by Apify separately from the per-item price of this Actor." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }