{ "openapi": "3.0.1", "info": { "title": "GDELT News Scraper — Articles, Timeline & Images", "description": "Scrape GDELT Project by keyword, topic, or GDELT query. Extract article titles, URLs, domains, dates, languages, countries, images, and tone for news monitoring, media analysis, and research. No API key, no login.", "version": "1.0", "x-build-id": "Pmq4vly3aNyWN2pcW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~gdelt-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-gdelt-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/logiover~gdelt-news-scraper/runs": { "post": { "operationId": "runs-sync-logiover-gdelt-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/logiover~gdelt-news-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-gdelt-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", "properties": { "query": { "title": "Search Query", "type": "string", "description": "GDELT query string. Supports keywords, quoted phrases, OR groups, minus exclusions, and field filters like sourcelang:english or sourcecountry:US. Example: \"artificial intelligence\" regulation. Leave blank to use the default topic.", "default": "artificial intelligence" }, "mode": { "title": "Mode", "enum": [ "articles", "timeline", "images" ], "type": "string", "description": "articles: returns matching news articles. timeline: returns coverage volume over time. images: returns articles with social images only.", "default": "articles" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum number of articles to scrape. GDELT's Document API returns at most 250 articles for one query. Ignored in timeline mode.", "default": 250 }, "timespan": { "title": "Timespan", "enum": [ "1d", "3d", "1w", "2w", "1m", "3m", "6m", "1y" ], "type": "string", "description": "How far back the primary Document API searches. Choose one of the supported presets.", "default": "3m" }, "language": { "title": "Language Filter", "enum": [ "", "english", "spanish", "french", "german", "italian", "portuguese", "dutch", "russian", "arabic", "chinese", "japanese", "korean", "turkish", "hindi", "indonesian", "polish", "swedish", "ukrainian", "vietnamese", "persian", "greek", "hebrew", "thai", "romanian" ], "type": "string", "description": "Filter by article language. Leave blank for all languages.", "default": "" }, "country": { "title": "Source Country Filter", "enum": [ "", "US", "GB", "CA", "AU", "IE", "IN", "DE", "FR", "IT", "ES", "PT", "NL", "BE", "CH", "AT", "SE", "NO", "DK", "FI", "PL", "RU", "UA", "TR", "GR", "IL", "AE", "SA", "EG", "ZA", "NG", "KE", "BR", "AR", "MX", "CL", "CO", "CN", "JP", "KR", "ID", "MY", "SG", "PH", "TH", "VN", "PK", "BD" ], "type": "string", "description": "Filter by the country the news source is based in. Leave blank for all countries.", "default": "" }, "sortBy": { "title": "Sort Order", "enum": [ "datedesc", "dateasc", "tonedesc", "toneasc", "hybridrel" ], "type": "string", "description": "Sort Document API articles by date, tone, or hybrid relevance. The export fallback reproduces date ascending/descending only and otherwise returns newest first.", "default": "datedesc" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for the primary Document API. If that API remains throttled, the Actor reads GDELT's official 15-minute export feed directly.", "default": { "useApifyProxy": 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 } } } } } } } } } }