{
  "openapi": "3.0.1",
  "info": {
    "title": "Google News Scraper: Real Article URLs, Full Text",
    "description": "Google News articles (headline, publisher, decoded publisher URL, date, snippet, image, story cluster) by keyword or topic; $3.60 per 1,000 articles. Article text $6.00 per 1,000. Any language, monitor mode, free error rows.",
    "version": "0.1",
    "x-build-id": "qufIIXhD2dT5Xi3OQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/arcadium~google-news/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-arcadium-google-news",
        "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/arcadium~google-news/runs": {
      "post": {
        "operationId": "runs-sync-arcadium-google-news",
        "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/arcadium~google-news/run-sync": {
      "post": {
        "operationId": "run-sync-arcadium-google-news",
        "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": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "Google News search terms, e.g. [\"openai\", \"electric cars\"]. Google News operators work: \"exact phrase\", OR, -word, intitle:word. Each query gives up to maxArticlesPerQuery articles, newest and most relevant first.",
            "items": {
              "type": "string"
            }
          },
          "topics": {
            "title": "Topic sections",
            "type": "array",
            "description": "Google News sections to read, e.g. BUSINESS or TECHNOLOGY. Section stories come grouped: each article lists the other outlets covering the same story (relatedCoverage). For a custom topic page use its news.google.com/topics/... URL in startUrls.",
            "items": {
              "type": "string",
              "enum": [
                "WORLD",
                "NATION",
                "BUSINESS",
                "TECHNOLOGY",
                "ENTERTAINMENT",
                "SPORTS",
                "SCIENCE",
                "HEALTH"
              ],
              "enumTitles": [
                "World",
                "Nation (country news)",
                "Business",
                "Technology",
                "Entertainment",
                "Sports",
                "Science",
                "Health"
              ]
            }
          },
          "topStories": {
            "title": "Top stories",
            "type": "boolean",
            "description": "Also read the Top stories page of the edition (the Google News front page), grouped by story with related coverage."
          },
          "locations": {
            "title": "Local news (city or region)",
            "type": "array",
            "description": "Local headlines for a place, e.g. [\"Berlin\", \"Austin, Texas\"], as on the Google News local section.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Google News URLs",
            "type": "array",
            "description": "news.google.com search, topic, story or publication URLs, with or without /rss, e.g. https://news.google.com/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB?hl=en-US&gl=US&ceid=US:en. The edition in the URL (hl, gl, ceid) is kept.",
            "items": {
              "type": "string"
            }
          },
          "sites": {
            "title": "Only these publishers",
            "type": "array",
            "description": "Publisher domains to keep, e.g. [\"reuters.com\", \"apnews.com\"]. Searches send them to Google as site: filters; sections and top stories are filtered by the publisher's domain.",
            "items": {
              "type": "string"
            }
          },
          "excludeWords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Words that must not appear in search results, e.g. [\"opinion\", \"podcast\"] (sent as -word). Searches only.",
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Edition language, e.g. en, de, fr, es, ja, pt-BR, zh-TW (default en). An edition id such as US:en or BR:pt-419 is accepted too and also sets the country."
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Edition country as a two-letter code, e.g. US, GB, DE, IN, BR (default US). Google News picks local outlets and ranking for it."
          },
          "timeRange": {
            "title": "Time window",
            "enum": [
              "1h",
              "1d",
              "7d",
              "30d",
              "1y",
              "any"
            ],
            "type": "string",
            "description": "Only articles published within this window before the run. For searches Google applies it; for sections and top stories it is filtered by the published date. A date range below wins over it."
          },
          "dateFrom": {
            "title": "Published on or after",
            "type": "string",
            "description": "Date as YYYY-MM-DD (e.g. 2026-10-01) or relative (e.g. 7 days). Searches send it as after:; other feeds are filtered by date."
          },
          "dateTo": {
            "title": "Published on or before",
            "type": "string",
            "description": "Date as YYYY-MM-DD (e.g. 2026-10-21) or relative (e.g. 1 day), inclusive. Searches send it as before: the next day."
          },
          "maxArticlesPerQuery": {
            "title": "Max articles per query or section",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Articles per query, section, location or URL, 1 to 5,000 (default 100). One Google News page holds about 100; above that a search is split into one-day windows across the date range (default the last 30 days)."
          },
          "maxItems": {
            "title": "Max articles in total",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stops the run after this many articles across all inputs, 1 to 1,000,000. A cost cap; leave empty for no limit."
          },
          "decodeUrls": {
            "title": "Decode publisher URLs",
            "type": "boolean",
            "description": "Turn Google's news.google.com/rss/articles/... redirect links into the publisher's real article URL (on by default). Off: faster, url stays null and only googleNewsUrl is set."
          },
          "includeSnippets": {
            "title": "Snippet and thumbnail",
            "type": "boolean",
            "description": "Read each article's page for its summary (snippet) and lead image (thumbnailUrl), on by default. Needs decodeUrls. Pages that block automated visits leave both empty."
          },
          "includeArticleText": {
            "title": "Full article text",
            "type": "boolean",
            "description": "Also extract the main text of each article (charged as article-text). Only text the publisher serves openly: paywalled or blocked pages are flagged in textStatus and charged as a plain article, never worked around. Author names are not included."
          },
          "includeRelated": {
            "title": "Related coverage list",
            "type": "boolean",
            "description": "List the other outlets' articles on the same story in relatedCoverage (on by default). Off keeps only relatedCount."
          },
          "dedupeStories": {
            "title": "One row per story",
            "type": "boolean",
            "description": "Keep only the lead article of each story; the other outlets' versions are listed in its relatedCoverage instead of getting their own rows. Fewer rows, lower cost."
          },
          "onlyNew": {
            "title": "Only new articles (monitor mode)",
            "type": "boolean",
            "description": "Return only articles not returned by an earlier run with the same stateKey, per query and edition. Schedule the actor and get each new article once. The first run returns the current list."
          },
          "stateKey": {
            "title": "Monitor state key",
            "type": "string",
            "description": "Name of the saved monitor state, e.g. brand-watch (1-40 letters, digits or dashes; default `default`). Use different keys for independent monitors with the same queries."
          },
          "includeErrorRows": {
            "title": "Add a row for inputs without data",
            "type": "boolean",
            "description": "Push a free row with rowType error (code and message) for every query or URL that gave nothing, so you can tell 'no results' from 'blocked'.",
            "default": true
          },
          "maxRetries": {
            "title": "Retries per request",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Retries for a Google News request that fails or is rate limited, 0 to 10 (default 4). Each retry uses a new IP."
          },
          "proxyConfiguration": {
            "title": "Proxy (advanced)",
            "type": "object",
            "description": "Advanced: leave empty. The actor uses Apify's datacenter proxy by itself. Only your own proxy URLs (proxyUrls) are used if set; Apify proxy groups are ignored."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}