{ "openapi": "3.0.1", "info": { "title": "Ultimate News API", "description": "Scrape up to 10000 news articles from over 4500 news sources in less than 20 minutes, news from over 20 categories, e.g., Crypto news, World News, Latest News, Celebrities, and a lot more.\nYou can find news on websites such as Fox News, BBC News, CNN, and Cryptocurrency-Related News Sources.", "version": "1.0", "x-build-id": "bavH4A1avO1mKvZkR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/glitch_404~Ultimate-News-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-glitch_404-Ultimate-News-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/glitch_404~Ultimate-News-Scraper/runs": { "post": { "operationId": "runs-sync-glitch_404-Ultimate-News-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/glitch_404~Ultimate-News-Scraper/run-sync": { "post": { "operationId": "run-sync-glitch_404-Ultimate-News-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": [ "categories", "date", "maxArticles" ], "properties": { "keywords": { "title": "Search by Keyword", "type": "string", "description": "separate keywords by a comma (e.g. 'apple, google, amazon')" }, "categories": { "title": "Categories to get news from", "minItems": 1, "maxItems": 27, "type": "array", "description": "Categories to scrape from if you want to scrape from all categories choose 'all'", "items": { "type": "string", "enum": [ "all", "general", "all-latest", "finance", "world", "u.s", "politics", "companies", "stockmarket", "forex", "commodities", "economy", "crypto-finance", "crypto", "cryptocurrencies", "metaverse", "nft", "defi", "crime", "technology", "celebrity", "health,lifestyle", "entertainment", "travel", "science", "yahoo-360", "food_and_drink" ], "enumTitles": [ "All News & Articles (please click on all categories manually for better outcomes (including this one too) )", "General Daily News", "Latest News & Articles", "Popular Finance News", "World News", "U.S. News", "Politics News", "Companies News", "Stocks Market", "Forex News", "Commodities News", "Economy News", "Crypto Finance News", "Crypto News", "Cryptocurrencies News", "The Crypto Metaverse", "NFT News", "Defi News", "Crime News", "Technologies News", "Celebrities News", "Health & Lifestyle", "Entertainment Articles", "Travel", "Science", "Yahoo-360", "Foods and Drinks articles" ] }, "default": [ "all" ] }, "date": { "title": "Date Range of News Articles", "minItems": 1, "maxItems": 1, "type": "array", "description": "scrape articles posted within a date range if you dont care about the date choose 'all'", "items": { "type": "string", "enum": [ "all", "today", "3d", "1w", "1m", "1y" ], "enumTitles": [ "All", "Today", "3 Days", "1 Week", "1 Month", "1 Year" ] }, "default": [ "today" ] }, "maxArticles": { "title": "Maximum Articles Amount", "minimum": 10, "maximum": 30000, "type": "integer", "description": "this scraper gets you data upto this number for example if you specify 1000 you might get 800 which is all the data that was found", "default": 100 }, "APIMode": { "title": "API Mode", "type": "boolean", "description": "If you have a website and want to use this actor as an api this feature will make the actor return HTML tags instead of text", "default": false }, "excludedPublishers": { "title": "Excluded a Specific Publisher", "type": "string", "description": "Exclude a specific publisher/s maybe you don't like 'FOX News' or 'CNN' to exclude multiple publishers separate them with a comma .e.g 'Fox News, CNN'" }, "allowedPublishers": { "title": "Only Allowed Publishers (all publishers are allowed by default)", "type": "string", "description": "you can allow very specific publishers and exclude all of the others" }, "proxyConfiguration": { "title": "Proxy configurations", "type": "object", "description": "Specifies proxies that will be used by the scraper (Optional)", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }