{
  "openapi": "3.0.1",
  "info": {
    "title": "RSS & News Full-Text for LLM & RAG (Multilingual)",
    "description": "Turn any RSS, Atom or JSON feed (or just a website URL) into clean full-text articles with language detection, de-duplication and ready-made RAG chunks. Respects robots.txt. Pay only for articles delivered.",
    "version": "0.1",
    "x-build-id": "n1cNTEHur4YJJw5uO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/henrycrawl~rss-news-fulltext-rag/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-henrycrawl-rss-news-fulltext-rag",
        "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/henrycrawl~rss-news-fulltext-rag/runs": {
      "post": {
        "operationId": "runs-sync-henrycrawl-rss-news-fulltext-rag",
        "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/henrycrawl~rss-news-fulltext-rag/run-sync": {
      "post": {
        "operationId": "run-sync-henrycrawl-rss-news-fulltext-rag",
        "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": [
          "feeds"
        ],
        "properties": {
          "feeds": {
            "title": "Feeds or websites",
            "type": "array",
            "description": "RSS, Atom, RDF or JSON Feed URLs - or just a website / section URL (e.g. https://techcrunch.com) and the feed is discovered automatically. Mix languages and countries freely; the same story appearing in several feeds is returned once.",
            "items": {
              "type": "string"
            }
          },
          "fullText": {
            "title": "Fetch full article text",
            "type": "boolean",
            "description": "Open each article and extract the clean main text (no menus, ads, comments). If off, only what the feed itself contains is returned (cheaper, faster). Articles whose site forbids it in robots.txt, blocks automated access, or shows only a paywall teaser come back with an error status and are NOT charged - unless the feed itself carries the full post.",
            "default": true
          },
          "maxItemsPerFeed": {
            "title": "Max articles per feed",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Newest items first, as ordered by the feed.",
            "default": 20
          },
          "maxItems": {
            "title": "Max articles in total",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap for the whole run (0 = no cap). Also limited by your max total charge.",
            "default": 0
          },
          "maxAgeHours": {
            "title": "Only articles newer than (hours)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip items published longer ago than this. 0 = no age limit. Ideal for scheduled monitoring (e.g. 24 for a daily run).",
            "default": 0
          },
          "includeKeywords": {
            "title": "Include keywords (any)",
            "type": "array",
            "description": "Keep only articles mentioning at least one keyword (whole-word, case-insensitive; substring match for Chinese/Japanese/Korean/Thai). With full text on, the article body is searched too. Filtered articles are not output and not charged.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop items whose title, summary or categories contain any of these.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "title": "Only these languages",
            "type": "array",
            "description": "ISO 639-1 codes such as en, de, ja, vi. Language is detected from the article text, not trusted from the feed. Empty = all languages.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "outputFormat": {
            "title": "Output format",
            "enum": [
              "articles",
              "chunks"
            ],
            "type": "string",
            "description": "\"One row per article\" keeps text, metadata and chunks together. \"One row per chunk\" gives flat rows (chunk text + article metadata) ready to embed and upsert into a vector database.",
            "default": "articles"
          },
          "includeChunks": {
            "title": "Add RAG chunks",
            "type": "boolean",
            "description": "Split each article into overlapping chunks along paragraph and sentence boundaries.",
            "default": true
          },
          "chunkTokens": {
            "title": "Chunk size (tokens)",
            "minimum": 50,
            "maximum": 8000,
            "type": "integer",
            "description": "Approximate tokens per chunk (Chinese/Japanese/Korean/Thai characters count as ~1 token each, other scripts ~4 characters per token).",
            "default": 500
          },
          "chunkOverlapTokens": {
            "title": "Chunk overlap (tokens)",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "Context repeated from the end of the previous chunk (whole sentences/paragraphs only).",
            "default": 50
          },
          "includeMarkdown": {
            "title": "Also return Markdown",
            "type": "boolean",
            "description": "Adds a `markdown` field with headings, lists and tables preserved.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max parallel sites",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Different websites fetched in parallel. Requests to the same website are always sequential and spaced out.",
            "default": 8
          },
          "perSiteDelaySecs": {
            "title": "Delay between requests to one site (s)",
            "minimum": 0.5,
            "maximum": 30,
            "type": "number",
            "description": "Politeness delay. A longer Crawl-delay in the site's robots.txt is honoured automatically.",
            "default": 1
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}