{
  "openapi": "3.0.1",
  "info": {
    "title": "News by Country & Language: 54 Google News Editions",
    "description": "Search or get top headlines from 54 country editions of Google News in one run. Original publisher URLs (not Google redirects), the same story merged across countries, related coverage, optional full article text. Clean JSON for AI agents. Pay per article.",
    "version": "0.1",
    "x-build-id": "W80aAIQLfxuyZE7x3"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/henrycrawl~news-by-country/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-henrycrawl-news-by-country",
        "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/henrycrawl~news-by-country/runs": {
      "post": {
        "operationId": "runs-sync-henrycrawl-news-by-country",
        "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/henrycrawl~news-by-country/run-sync": {
      "post": {
        "operationId": "run-sync-henrycrawl-news-by-country",
        "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": {
          "query": {
            "title": "Search words",
            "type": "string",
            "description": "What to search for, in the language of the countries you pick (Google News search syntax works: quotes, OR, -word, site:). Leave empty to get the top headlines of each country."
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Country editions of Google News to read (each in its own language). 54 available.",
            "items": {
              "type": "string",
              "enum": [
                "US",
                "GB",
                "CA",
                "AU",
                "IN",
                "IE",
                "NZ",
                "ZA",
                "SG",
                "PH",
                "NG",
                "KE",
                "MY",
                "PK",
                "DE",
                "AT",
                "CH",
                "FR",
                "BE",
                "ES",
                "MX",
                "AR",
                "CO",
                "CL",
                "PE",
                "IT",
                "PT",
                "BR",
                "NL",
                "PL",
                "CZ",
                "SK",
                "HU",
                "RO",
                "BG",
                "GR",
                "SE",
                "NO",
                "FI",
                "TR",
                "UA",
                "RU",
                "IL",
                "AE",
                "SA",
                "EG",
                "JP",
                "KR",
                "CN",
                "TW",
                "HK",
                "VN",
                "TH",
                "ID"
              ],
              "enumTitles": [
                "United States",
                "United Kingdom",
                "Canada",
                "Australia",
                "India",
                "Ireland",
                "New Zealand",
                "South Africa",
                "Singapore",
                "Philippines",
                "Nigeria",
                "Kenya",
                "Malaysia",
                "Pakistan",
                "Germany",
                "Austria",
                "Switzerland",
                "France",
                "Belgium",
                "Spain",
                "Mexico",
                "Argentina",
                "Colombia",
                "Chile",
                "Peru",
                "Italy",
                "Portugal",
                "Brazil",
                "Netherlands",
                "Poland",
                "Czechia",
                "Slovakia",
                "Hungary",
                "Romania",
                "Bulgaria",
                "Greece",
                "Sweden",
                "Norway",
                "Finland",
                "Turkey",
                "Ukraine",
                "Russia",
                "Israel",
                "United Arab Emirates",
                "Saudi Arabia",
                "Egypt",
                "Japan",
                "South Korea",
                "China",
                "Taiwan",
                "Hong Kong",
                "Vietnam",
                "Thailand",
                "Indonesia"
              ]
            }
          },
          "topic": {
            "title": "Headlines topic (when no search words)",
            "enum": [
              "top",
              "world",
              "nation",
              "business",
              "technology",
              "entertainment",
              "sports",
              "science",
              "health"
            ],
            "type": "string",
            "description": "Section to read when 'Search words' is empty.",
            "default": "top"
          },
          "timeRange": {
            "title": "Published within",
            "enum": [
              "1h",
              "1d",
              "7d",
              "30d",
              "any"
            ],
            "type": "string",
            "description": "Only for searches: how recent the articles must be.",
            "default": "7d"
          },
          "maxArticlesPerCountry": {
            "title": "Max articles per country",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Articles kept per country after merging duplicates (Google News lists up to 100 per search).",
            "default": 20
          },
          "deduplicate": {
            "title": "Merge the same story across countries",
            "type": "boolean",
            "description": "Keep one row per story; other countries / publishers that ran it are listed in alsoReportedBy.",
            "default": true
          },
          "resolveUrls": {
            "title": "Resolve original publisher URLs",
            "type": "boolean",
            "description": "Turn Google News redirect links into the publisher's real article URL (recommended; needed for full text).",
            "default": true
          },
          "includeFullText": {
            "title": "Include full article text",
            "type": "boolean",
            "description": "Download each article and extract the main text (charged per article that returns text).",
            "default": false
          },
          "language": {
            "title": "Language override",
            "type": "string",
            "description": "Optional Google News language code to use for every country instead of its main language, e.g. 'en' to read the English edition view of a country."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}