{ "openapi": "3.0.1", "info": { "title": "FeedHound - RSS Feed Finder, Reader & Health Check", "description": "Give it a website and it finds the RSS, Atom, RDF and JSON feeds behind it, checks that each one really works, and returns the posts in one clean shape. Podcast tags included. You never need to know the feed URL. A site with no working feed is never charged for.", "version": "0.1", "x-build-id": "iJbAILOLfoHppQS0a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abusch500~feedhound-rss-feed-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abusch500-feedhound-rss-feed-finder", "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/abusch500~feedhound-rss-feed-finder/runs": { "post": { "operationId": "runs-sync-abusch500-feedhound-rss-feed-finder", "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/abusch500~feedhound-rss-feed-finder/run-sync": { "post": { "operationId": "run-sync-abusch500-feedhound-rss-feed-finder", "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": [ "sources" ], "properties": { "sources": { "title": "Websites or feed URLs", "type": "array", "description": "One per line. A website (bbc.com), a section (bbc.com/news), or a feed URL you already have - all three work. If you give a website, FeedHound finds its feeds for you.", "items": { "type": "string" } }, "maxFeedsPerSource": { "title": "Most feeds to return per source", "minimum": 1, "maximum": 25, "type": "integer", "description": "Many sites publish several feeds - all posts, one per category, a podcast. The price is per source, not per feed, so raising this costs nothing extra.", "default": 5 }, "maxItemsPerFeed": { "title": "Most posts to return per feed", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many posts come back in each row. Set it to 0 for feed details and health only. The health report is always calculated on every post in the feed, not just the ones returned.", "default": 50 }, "includeItems": { "title": "Include the posts", "type": "boolean", "description": "Leave this on to get the posts themselves. Turn it off for a smaller result when you only want to know which feeds exist and whether they are healthy.", "default": true }, "probeCommonPaths": { "title": "Guess feed addresses when a site advertises none", "type": "boolean", "description": "Tries the standard addresses (/feed, /rss, /index.xml and a few more) only when a site links to no feed at all. Every guess still obeys that site's robots.txt.", "default": true }, "maxConcurrency": { "title": "Sources at a time", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many sources to work through in parallel. Requests to the same site are always spaced out no matter what this is set to.", "default": 5 }, "requestTimeoutSecs": { "title": "Timeout per request (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each request before giving up. Raise it for slow sites, lower it to move faster through a big list.", "default": 20 }, "respectRobotsTxt": { "title": "Obey robots.txt", "type": "boolean", "description": "Leave this on. It is the reason this actor is safe to point at sites you do not own. Turn it off only for your own domains.", "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 } } } } } } } } } }