{ "openapi": "3.0.1", "info": { "title": "News Search API: Multi-Source Headlines", "description": "Search news by keyword and get headlines, publisher, article link and date from the free GDELT DOC 2.0 API, plus NewsAPI with your own optional key. Merged and deduplicated. Language, country and time filters. No full article text.", "version": "2.0", "x-build-id": "DsRRPW9pNuYPZO2Iu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spider355~news-search-google-bing/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spider355-news-search-google-bing", "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/spider355~news-search-google-bing/runs": { "post": { "operationId": "runs-sync-spider355-news-search-google-bing", "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/spider355~news-search-google-bing/run-sync": { "post": { "operationId": "run-sync-spider355-news-search-google-bing", "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": [ "queries" ], "properties": { "queries": { "title": "Search queries", "maxItems": 50, "type": "array", "description": "One search per line. Exact phrases in \"quotes\", -exclude, and (a OR b) with brackets work; site:example.com is sent to GDELT as domain:example.com. 1 to 50 queries, each up to 500 characters. GDELT rejects very short single words (under 3 letters).", "items": { "type": "string" } }, "timeRange": { "title": "Published within", "enum": [ "any", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Keep only articles published in this period. GDELT covers about the last 3 months, so \"Past year\" and \"Any time\" return GDELT articles from that window only.", "default": "week" }, "language": { "title": "Language", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter language code of the article, for example en, de, fr, es, pt, ja.", "default": "en" }, "country": { "title": "Publisher country (GDELT)", "pattern": "^([A-Za-z]{2})?$", "type": "string", "description": "Optional two-letter country code of the news outlet, for example US, GB, DE, AU, NZ. Leave empty for all countries. Applies to GDELT only." }, "sources": { "title": "Sources", "type": "array", "description": "GDELT is free and needs no key. NewsAPI needs your own key (below). Leave empty for GDELT, plus NewsAPI when a key is given.", "items": { "type": "string", "enum": [ "gdelt", "newsapi" ], "enumTitles": [ "GDELT DOC 2.0 (free, no key)", "NewsAPI (your own key)" ] } }, "newsApiKey": { "title": "NewsAPI key (optional, your own)", "type": "string", "description": "Optional. Your own key from newsapi.org. It is sent only in the X-Api-Key request header to newsapi.org and is never logged or saved in the output. Your NewsAPI plan's terms apply (the free Developer plan is for development only)." }, "maxResultsPerQuery": { "title": "Maximum articles per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper limit of articles returned for each query, newest first.", "default": 100 } } }, "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 } } } } } } } } } }