{
  "openapi": "3.0.1",
  "info": {
    "title": "Google News Full Coverage Clusters & Publisher Timeline",
    "description": "Read Google News Full Coverage story clusters with every coverage group, publisher, decoded article URL, exact publish time, thumbnail, source count, top publishers and a monitored timeline of new articles.",
    "version": "1.0",
    "x-build-id": "nDx7TZqHEeij5EPx0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/xyrelith-data~google-news-full-coverage/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-xyrelith-data-google-news-full-coverage",
        "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/xyrelith-data~google-news-full-coverage/runs": {
      "post": {
        "operationId": "runs-sync-xyrelith-data-google-news-full-coverage",
        "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/xyrelith-data~google-news-full-coverage/run-sync": {
      "post": {
        "operationId": "run-sync-xyrelith-data-google-news-full-coverage",
        "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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "sections",
              "keywords",
              "storyUrls"
            ],
            "type": "string",
            "description": "What to discover. `sections` reads Google News topic/home pages and expands each story's Full Coverage page. `keywords` reads Google News RSS search results (article/cluster-lite; Google blocks the HTML search page for datacenter IPs). `storyUrls` expands Full Coverage story URLs directly.",
            "default": "sections"
          },
          "edition": {
            "title": "Edition (country + language)",
            "enum": [
              "US:en",
              "US:es-419",
              "GB:en",
              "IE:en",
              "CA:en",
              "CA:fr",
              "AU:en",
              "NZ:en",
              "IN:en",
              "IN:hi",
              "SG:en",
              "PH:en",
              "NG:en",
              "ZA:en",
              "KE:en",
              "GH:en",
              "ET:en",
              "TZ:en",
              "UG:en",
              "ZW:en",
              "BW:en",
              "NA:en",
              "PK:en",
              "IL:en",
              "IL:he",
              "LV:en",
              "LV:lv",
              "LT:lt",
              "EE:et",
              "DE:de",
              "AT:de",
              "CH:de",
              "FR:fr",
              "BE:fr",
              "CH:fr",
              "MA:fr",
              "SN:fr",
              "ES:es",
              "ES:ca",
              "MX:es-419",
              "AR:es-419",
              "CO:es-419",
              "CL:es-419",
              "PE:es-419",
              "VE:es-419",
              "CU:es-419",
              "BR:pt-419",
              "PT:pt-150",
              "IT:it",
              "NL:nl",
              "BE:nl",
              "NO:no",
              "SE:sv",
              "FI:fi",
              "DK:da",
              "PL:pl",
              "CZ:cs",
              "SK:sk",
              "HU:hu",
              "RO:ro",
              "BG:bg",
              "GR:el",
              "TR:tr",
              "RU:ru",
              "UA:uk",
              "SA:ar",
              "AE:ar",
              "EG:ar",
              "BD:bn",
              "LK:si",
              "NP:ne",
              "TH:th",
              "VN:vi",
              "ID:id",
              "ID:en",
              "MY:ms",
              "JP:ja",
              "KR:ko",
              "TW:zh-Hant",
              "HK:zh-Hant",
              "CN:zh-Hans"
            ],
            "type": "string",
            "description": "Google News edition. Country and language travel together. Story IDs are edition-specific.",
            "default": "US:en"
          },
          "sections": {
            "title": "Sections (mode=sections)",
            "type": "array",
            "description": "Google News sections to read: topStories, us, world, business, technology, entertainment, sports, science, health. `topStories` reads the front page; the rest read topic pages. Each story is expanded to its Full Coverage page.",
            "items": {
              "type": "string"
            },
            "default": [
              "topStories"
            ]
          },
          "keywords": {
            "title": "Keywords (mode=keywords)",
            "type": "array",
            "description": "Google News RSS search queries. Supports Google News search operators such as quotes, OR, -term, site:, intitle:, when:1d, when:7d, after:, before:. Each result is emitted with the coverage links Google returns (usually 1-5 articles).",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "storyUrls": {
            "title": "Story URLs (mode=storyUrls)",
            "type": "array",
            "description": "Google News Full Coverage URLs or story tokens, e.g. `https://news.google.com/stories/CAAq...`. Paste one or more.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "coverageSections": {
            "title": "Coverage groups to include",
            "type": "array",
            "description": "Optional filter for Full Coverage groups: Top news, All coverage, From the region, Opinion, Fact check, FAQ, Timeline, Posts on X, Personal perspective, In-depth, For context, Interviews, By the numbers. Leave empty for all. RSS rows are always included; this filter applies to Full Coverage pages.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxStories": {
            "title": "Max stories",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum story clusters to process across all selected sections, keywords or URLs.",
            "default": 20
          },
          "maxArticlesPerStory": {
            "title": "Max articles per story",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum article rows emitted per cluster. Story statistics still describe the whole cluster Google served.",
            "default": 10
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on dataset rows.",
            "default": 100
          },
          "trackNewArticles": {
            "title": "Track new articles",
            "type": "boolean",
            "description": "Compare each cluster with the previous run and add `isNew`, `firstSeenAt` and `storyNewArticleCount`. State is stored in the actor's key-value store; schedule the actor to build a timeline.",
            "default": false
          },
          "resetTracking": {
            "title": "Reset stored history",
            "type": "boolean",
            "description": "Forget previously seen articles for the clusters processed in this run, then treat every article as new.",
            "default": false
          },
          "decodePublisherUrls": {
            "title": "Decode publisher URLs",
            "type": "boolean",
            "description": "Resolve Google News RSS links to the original publisher URL in keyword mode. Full Coverage pages already expose original URLs. Disable to reduce requests when you only need Google links.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}