{
  "openapi": "3.0.1",
  "info": {
    "title": "Google News Scraper — Headlines & CSV Export",
    "description": "Search Google News headlines by keyword, company, brand, or topic. Filter by date range and country edition. Export headlines, sources, dates, and links to CSV or JSON, with optional direct publisher URLs. $0.20/1K records + $0.0015/run. No full article text.",
    "version": "0.1",
    "x-build-id": "qqroxWwNkHs4eASab"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/monkey.d.scraping~google-news-scraper-lite/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-monkey.d.scraping-google-news-scraper-lite",
        "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/monkey.d.scraping~google-news-scraper-lite/runs": {
      "post": {
        "operationId": "runs-sync-monkey.d.scraping-google-news-scraper-lite",
        "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/monkey.d.scraping~google-news-scraper-lite/run-sync": {
      "post": {
        "operationId": "run-sync-monkey.d.scraping-google-news-scraper-lite",
        "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": "Keywords or topics",
            "minItems": 1,
            "maxItems": 20,
            "type": "array",
            "description": "One company, person or topic per line, up to 20. For an exact name, include quotation marks, e.g. \"Microsoft\". Matching articles are deduplicated across searches.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "edition": {
            "title": "Country and language",
            "enum": [
              "it-IT",
              "en-US",
              "en-GB",
              "de-DE",
              "fr-FR",
              "es-ES",
              "en-CA",
              "en-AU",
              "en-IN",
              "fr-CA",
              "pt-BR",
              "nl-NL",
              "ja-JP"
            ],
            "type": "string",
            "description": "Select a Google News country edition and its language together.",
            "default": "it-IT"
          },
          "period": {
            "title": "News from",
            "enum": [
              "day",
              "week",
              "month",
              "custom"
            ],
            "type": "string",
            "description": "Choose a rolling period, or Custom dates with advanced mode. Custom dates are inclusive in UTC.",
            "default": "week"
          },
          "maxItemsPerQuery": {
            "title": "Maximum articles per keyword",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "Start with 10 (up to $0.0035 including startup for one keyword). Above 100, choose Advanced; Search more date windows is then enabled automatically. Maximum 300 per keyword; results depend on availability.",
            "default": 50
          },
          "mode": {
            "title": "Collection mode",
            "enum": [
              "simple",
              "advanced"
            ],
            "type": "string",
            "description": "Simple: recent headlines and optional direct links, up to 100 per keyword. Advanced: custom dates, up to 300 with expanded coverage, and optional descriptions/images.",
            "default": "simple"
          },
          "resolveArticleUrls": {
            "title": "Get direct article links",
            "type": "boolean",
            "description": "Resolve publisher links for the collected records, up to 20 keywords × 300 articles with expanded coverage. Uses the processing time budget; unavailable links stay empty with an explicit status.",
            "default": false
          },
          "dateFrom": {
            "title": "From date (UTC)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Advanced + Custom dates. Both dates required, from 1970 onward, up to 3660 days and no future dates. Ranges longer than 366 days are automatically split into consecutive windows."
          },
          "dateTo": {
            "title": "Through date (UTC)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Inclusive final date in UTC. Choose Custom dates above and provide both dates."
          },
          "expandCoverage": {
            "title": "Search more date windows",
            "type": "boolean",
            "description": "Enabled automatically above 100 articles per keyword. Choose Advanced first. Searches additional date windows, up to 16 feeds per keyword, and removes duplicate article IDs. More results are not guaranteed.",
            "default": false
          },
          "enrichArticles": {
            "title": "Get publisher descriptions and images",
            "type": "boolean",
            "description": "Advanced mode. Automatically resolves direct links, then reads publisher descriptions and images for collected records within the processing time budget. Identical URLs share a metadata fetch. Unavailable fields remain empty. No full article text.",
            "default": false
          },
          "processingBudgetSeconds": {
            "title": "Processing time budget",
            "minimum": 60,
            "maximum": 3600,
            "type": "integer",
            "description": "Default 15 minutes; new runs have a 16-minute timeout. Older saved tasks may still use 120 seconds: increase their run timeout for larger enriched searches. If you raise this budget, set the timeout at least 30 seconds higher. Maximum cost per run is a separate spending limit.",
            "default": 900
          },
          "includeTitleTerms": {
            "title": "Keep headlines containing any of these phrases",
            "maxItems": 20,
            "type": "array",
            "description": "Optional literal words or phrases, case-insensitive. A headline must contain at least one; leave empty to keep all. Example: Mario Calabresi. Applied before saving and charging.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "excludeTitleTerms": {
            "title": "Exclude headlines containing any of these phrases",
            "maxItems": 20,
            "type": "array",
            "description": "Optional literal words or phrases, case-insensitive. Matching headlines are excluded before saving and charging. Filtering counts appear in the summary.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "strictMode": {
            "title": "Fail when requested publisher data is incomplete",
            "type": "boolean",
            "description": "Off: unavailable optional publisher links or metadata produce warnings while collected headlines remain usable. On: incomplete requested output fails the run. Collection and storage errors still fail regardless.",
            "default": 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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}