{
  "openapi": "3.0.1",
  "info": {
    "title": "Google News Scraper — Company & Competitor News",
    "description": "Track company and competitor news on Google News. Search up to 20 keywords by date in 13 editions. Export deduplicated headlines, publishers and matching keywords to CSV or JSON. Optional publisher URLs. $0.20/1K records + $0.0015/run.",
    "version": "0.1",
    "x-build-id": "FyWJpNZVwPwVZCer0"
  },
  "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": "Past 24 hours, 7 days or 30 days, or Custom dates for a historical search. Filling in a date below selects Custom dates automatically.",
            "default": "week"
          },
          "dateFrom": {
            "title": "From date (UTC)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "For historical searches, from 1970 onward. Leave empty for the rolling periods above. Long ranges, up to ten years, are searched in consecutive date windows automatically."
          },
          "dateTo": {
            "title": "Through date (UTC)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Inclusive final date. Leave empty to search up to today; future dates are set to today."
          },
          "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). Up to 300 per keyword; above 100, more date windows are searched automatically. Results depend on availability.",
            "default": 50
          },
          "expandCoverage": {
            "title": "Search more date windows",
            "type": "boolean",
            "description": "Splits the period into smaller date windows to find more articles per keyword and removes duplicates. Recommended for custom dates longer than a few months. Turned on automatically above 100 articles per keyword; takes longer.",
            "default": false
          },
          "resolveArticleUrls": {
            "title": "Get direct article links",
            "type": "boolean",
            "description": "Adds the direct publisher URL to each collected article; takes longer. Unavailable links stay empty with an explicit status.",
            "default": false
          },
          "enrichArticles": {
            "title": "Get publisher descriptions and images",
            "type": "boolean",
            "description": "Adds the publisher description and image of each article when available, and turns on direct links automatically. Does not include full article text.",
            "default": false
          },
          "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
            }
          },
          "processingBudgetSeconds": {
            "title": "Processing time budget",
            "minimum": 60,
            "maximum": 3600,
            "type": "integer",
            "description": "Default 15 minutes. The default run timeout is 60 minutes, so budgets up to 3,570 seconds need no other change; for 3,600, raise the run timeout slightly. The maximum cost per run is a separate spending limit.",
            "default": 900
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}