> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape Google News (search or section) > Searches Google News for `q`, or lists a section with `topic` (world, nation, business, technology, entertainment, sports, science, health, top, or a topic id), and returns `articles`: `position`, `title`, `url` (the publisher's article URL), `source`, `sourceUrl`, `publishedAt` (ISO 8601 UTC), `imageUrl` (+ `imageWidth`/`imageHeight`), `authors`, `googleNewsId` and `googleNewsUrl`. Metadata only - no article text. Narrow a search with `when` (e.g. '1d') or `after`/`before` dates; pick the edition with `hl` and `gl`. Google News answers a search with up to about 100 articles (no paging - use date windows to go further back). One unit per call. ## OpenAPI ````yaml /api-reference/openapi.json post /search/google-news openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Documented here: page-source extraction, Google SERP scraping, image fetch, and the dedicated plugin endpoints (search engines, marketplaces, reviews, travel, social and more). All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /search/google-news: post: tags: - Plugins summary: Scrape Google News (search or section) description: >- Searches Google News for `q`, or lists a section with `topic` (world, nation, business, technology, entertainment, sports, science, health, top, or a topic id), and returns `articles`: `position`, `title`, `url` (the publisher's article URL), `source`, `sourceUrl`, `publishedAt` (ISO 8601 UTC), `imageUrl` (+ `imageWidth`/`imageHeight`), `authors`, `googleNewsId` and `googleNewsUrl`. Metadata only - no article text. Narrow a search with `when` (e.g. '1d') or `after`/`before` dates; pick the edition with `hl` and `gl`. Google News answers a search with up to about 100 articles (no paging - use date windows to go further back). One unit per call. operationId: google_news_search_google_news_post parameters: - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Search query, e.g. 'tesla' or '"web scraping"'. Google News operators work: quotes, OR, -word, site:reuters.com, intitle:. Pass either `q` or `topic`. title: Q description: >- Search query, e.g. 'tesla' or '"web scraping"'. Google News operators work: quotes, OR, -word, site:reuters.com, intitle:. Pass either `q` or `topic`. - name: topic in: query required: false schema: anyOf: - type: string - type: 'null' description: >- A section instead of a search: world, nation, business, technology, entertainment, sports, science, health, or top (the edition's headlines). A Google News topic id (the 'CAAq...' part of a news.google.com/topics/ URL) also works. title: Topic description: >- A section instead of a search: world, nation, business, technology, entertainment, sports, science, health, or top (the edition's headlines). A Google News topic id (the 'CAAq...' part of a news.google.com/topics/ URL) also works. - name: hl in: query required: false schema: type: string description: >- Language of the Google News edition, e.g. 'en', 'en-GB', 'de', 'fr', 'pt-BR'. default: en title: Hl description: >- Language of the Google News edition, e.g. 'en', 'en-GB', 'de', 'fr', 'pt-BR'. - name: gl in: query required: false schema: type: string description: >- Country of the Google News edition (2-letter code), e.g. 'us', 'gb', 'de'. default: us title: Gl description: >- Country of the Google News edition (2-letter code), e.g. 'us', 'gb', 'de'. - name: when in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only articles from the last period: '1h' to '720h', '1d', '7d', '2w', '1m', '1y'. Search (`q`) only. title: When description: >- Only articles from the last period: '1h' to '720h', '1d', '7d', '2w', '1m', '1y'. Search (`q`) only. - name: after in: query required: false schema: anyOf: - type: string - type: 'null' description: Only articles published after this date (YYYY-MM-DD). Search only. title: After description: Only articles published after this date (YYYY-MM-DD). Search only. - name: before in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only articles published before this date (YYYY-MM-DD). Search only. title: Before description: Only articles published before this date (YYYY-MM-DD). Search only. - name: max_results in: query required: false schema: type: integer description: >- Most articles to return, 1-250. Google News returns up to about 100 articles for a search and about 250 for a section; one call is billed one unit whatever the count. default: 100 title: Max Results description: >- Most articles to return, 1-250. Google News returns up to about 100 articles for a search and about 250 for a section; one call is billed one unit whatever the count. responses: '200': description: JSON with an `articles` array. content: application/json: schema: {} '400': description: Invalid parameters. '404': description: Google News has no articles for the query, or no such topic. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: >- Blocked by Google News on every attempt, an unusable answer, or no answer in time. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.