{
  "openapi": "3.0.1",
  "info": {
    "title": "Google News Scraper | Google News Alerts, Archive by Date",
    "description": "Scrape Google News by keyword, topic, site, language and country at $1.00 per 1,000 articles: title, publisher, the real article link decoded from Google's redirect, publish time; any time window or date range, past the 100-result limit. Optional full text, only-new alerts.",
    "version": "0.1",
    "x-build-id": "JsjdjGcu2sUevsgjD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aurelix~google-news-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aurelix-google-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/aurelix~google-news-scraper/runs": {
      "post": {
        "operationId": "runs-sync-aurelix-google-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/aurelix~google-news-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-aurelix-google-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": {
          "queries": {
            "title": "Search queries",
            "maxItems": 50,
            "type": "array",
            "description": "Keywords or phrases, one per line, e.g. 'electric vehicles' or '\"interest rates\" -crypto'. Google News search operators work: quotes, OR, -word, intitle:, site:, when:7d, after:2026-01-01 before:2026-02-01 (a query with its own when:/after:/before: ignores the time window below).",
            "items": {
              "type": "string"
            }
          },
          "topics": {
            "title": "Topics (optional)",
            "maxItems": 9,
            "type": "array",
            "description": "Google News topic sections of the chosen edition. Topic feeds list the section's current articles (about 30-80); the time window and site filter are applied to them after reading.",
            "items": {
              "type": "string",
              "enum": [
                "TOP_STORIES",
                "WORLD",
                "NATION",
                "BUSINESS",
                "TECHNOLOGY",
                "ENTERTAINMENT",
                "SPORTS",
                "SCIENCE",
                "HEALTH"
              ],
              "enumTitles": [
                "Top stories",
                "World",
                "Nation (the edition's country)",
                "Business",
                "Technology",
                "Entertainment",
                "Sports",
                "Science",
                "Health"
              ]
            },
            "default": []
          },
          "sites": {
            "title": "Only these sites (optional)",
            "maxItems": 20,
            "type": "array",
            "description": "Publisher domains, e.g. reuters.com, bbc.com. Searches get site:… added (several sites are ORed); topic articles are kept only when their publisher is one of these. Sites alone (no query) list those sites' newest articles.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "timeWindow": {
            "title": "Time window",
            "enum": [
              "1h",
              "1d",
              "7d",
              "30d",
              "any",
              "custom"
            ],
            "type": "string",
            "description": "How far back to look. Last day, week and month windows and date ranges that hold more than Google's 100 articles per search are split into smaller date ranges automatically, so you get up to 'Max articles per query', not 100.",
            "default": "7d"
          },
          "dateFrom": {
            "title": "From date (date range)",
            "type": "string",
            "description": "First day, YYYY-MM-DD, used when the time window is 'Date range'. Days are matched on the article's UTC publish date."
          },
          "dateTo": {
            "title": "To date (date range)",
            "type": "string",
            "description": "Last day (included), YYYY-MM-DD, used when the time window is 'Date range'. Empty = today."
          },
          "maxArticlesPerQuery": {
            "title": "Max articles per query",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many articles to return per query or topic, at most (fewer when Google News has fewer). Above 100 the window is split into date ranges to go past Google's 100-per-search limit.",
            "default": 100
          },
          "language": {
            "title": "Language (hl)",
            "type": "string",
            "description": "Google News interface language of the edition, e.g. en-US, en-GB, fr, de, es-419, ja.",
            "default": "en-US"
          },
          "country": {
            "title": "Country (gl)",
            "type": "string",
            "description": "Two-letter country of the edition, e.g. US, GB, CA, FR, DE, IN. A language Google News does not offer in that country ends the run with a free status row naming the edition Google offers instead.",
            "default": "US"
          },
          "ceid": {
            "title": "Edition ID (ceid, optional)",
            "type": "string",
            "description": "Google's edition ID, e.g. US:en, CA:fr, MX:es-419. Leave empty to derive it from language and country."
          },
          "includeFullText": {
            "title": "Include full article text",
            "type": "boolean",
            "description": "Also read each article on the publisher's site and return its text as Markdown with a word count ($0.001 per article with text, see Pricing). Publishers whose robots.txt disallows it, paywalled pages and pages without readable text are skipped with a reason and not charged.",
            "default": false
          },
          "incremental": {
            "title": "Only new articles since last run",
            "type": "boolean",
            "description": "Return only articles a previous run with the same queries, topics, sites and edition did not return, e.g. for a daily or hourly schedule. Articles already returned are skipped and not charged.",
            "default": false
          },
          "stateKey": {
            "title": "Only-new memory name (optional)",
            "type": "string",
            "description": "Name for the 'only new' memory, e.g. 'brand-mentions-daily', so two schedules on the same queries keep separate memories. Leave empty to derive it from the queries."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL (optional)",
            "type": "string",
            "description": "After each run, post a short digest to Slack: how many articles were saved (new ones only when 'Only new articles' is on), counts by publisher and the first 10 with links, e.g. https://hooks.slack.com/services/T000/B000/XXXX. Nothing is posted when the run saved no article."
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "After each run, POST the same digest as JSON (actor, newOnly, count, items = first 10 rows, runUrl, datasetUrl, text) to any URL, e.g. a Zapier, Make or n8n webhook, or an email automation. Nothing is sent when the run saved no article."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy used to read Google News's RSS feeds. The default, Apify datacenter proxy, is included in the price. Residential proxy is not needed and falls back to datacenter. Decoding article links and reading publisher pages (full text) always go directly from the run's server: through a proxy the link look-ups were up to 50 times slower.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}