Skip to content
Scrappa Get API key
Google News API 1 credit/request

Google News Publication API

GET https://scrappa.co/api/google/news/publication

Latest Google News articles of one publisher. Send its domain or a publication_token. Up to 100 items. Items from other publishers are removed. Each item has position, title (publisher name removed), link, source (name and url), date (ISO 8601), guid and related_articles (the other articles of the same story). Costs 1 credit. No result returns 200 with an empty list and costs nothing.

Google News Publication API 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/google/news/publication
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "channel": {
        "name": "Top stories",
        "title": "Top stories - Google News",
        "language": "en-US",
        "topic_token": null,
        "last_build_date": "2026-11-01T02:39:41+00:00"
    },
    "news_results": [
        {
            "date": "2026-11-01T02:29:35+00:00",
            "guid": "CBMidkFVX3lxTE9YR1owcUlLb3d1ajhFeWJacmU2aXAwV1g2Uk9aUjhtNFFNSlRSMXFxR2RCaWlIUWZ5M0w2M2kwODVndGNuSFdUangydkM0b0p5WERGOFY5QjZtSzNnYnhZTFd5NW1yZ2d6amJwMk9sdll6ZXdQeWc",
            "link": "https://news.google.com/rss/articles/CBMidkFVX3lxTE9YR1owcUlLb3d1ajhFeWJacmU2aXAwV1g2Uk9aUjhtNFFNSlRSMXFxR2RCaWlIUWZ5M0w2M2kwODVndGNuSFdUangydkM0b0p5WERGOFY5QjZtSzNnYnhZTFd5NW1yZ2d6amJwMk9sdll6ZXdQeWc?oc=5",
            "title": "2026 Elections Live Updates: Candidates Campaign in Battleground States on Final Weekend",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

4 optional filters available.

domain string Optional

Publisher domain, e.g. nytimes.com. Send this or publication_token.

Example value example.com
publication_token string Optional

Google News publication token. Send this or domain.

Example value example
hl string Optional

Language of the feed, 2 letters, e.g. en, de, fr. Default: en.

Example value en
gl string Optional

Country of the feed, 2 letters, e.g. us, de, gb. Default: us.

Example value us

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

channel news_results search_parameters

Common news_results fields

date guid link title
JSON Response
200 OK
{
    "channel": {
        "name": "Top stories",
        "title": "Top stories - Google News",
        "language": "en-US",
        "topic_token": null,
        "last_build_date": "2026-11-01T02:39:41+00:00"
    },
    "news_results": [
        {
            "date": "2026-11-01T02:29:35+00:00",
            "guid": "CBMidkFVX3lxTE9YR1owcUlLb3d1ajhFeWJacmU2aXAwV1g2Uk9aUjhtNFFNSlRSMXFxR2RCaWlIUWZ5M0w2M2kwODVndGNuSFdUangydkM0b0p5WERGOFY5QjZtSzNnYnhZTFd5NW1yZ2d6amJwMk9sdll6ZXdQeWc",
            "link": "https://news.google.com/rss/articles/CBMidkFVX3lxTE9YR1owcUlLb3d1ajhFeWJacmU2aXAwV1g2Uk9aUjhtNFFNSlRSMXFxR2RCaWlIUWZ5M0w2M2kwODVndGNuSFdUangydkM0b0p5WERGOFY5QjZtSzNnYnhZTFd5NW1yZ2d6amJwMk9sdll6ZXdQeWc?oc=5",
            "title": "2026 Elections Live Updates: Candidates Campaign in Battleground States on Final Weekend",
            "source": {
                "url": "https://www.nytimes.com",
                "name": "The New York Times"
            },
            "position": 1,
            "related_articles": [
                {
                    "link": "https://news.google.com/rss/articles/CBMijAFBVV95cUxOWmp6ZkYyZTFHVXB5NzhGaENaN2tQZXBlUWxKcG1aYVVMZ3dBOUJhZTNhdmNmVEk4dmFuVm1STFFNa05uZElRdGhYYUhxcVVLUDQtb1RfTDV2a0dmQlN2M2xVMGtOZ2c5eXYyWVdmSVNqV05TTTlGY0pIVDg5dnhaSDVjS0RwVkVNQU44aA?oc=5",
                    "title": "El-Sayed campaign wants Stevens to stay away after day of back-and-forth sniping",
                    "source": {
                        "name": "Politico"
                    }
                }
            ]
        }
    ],
    "search_parameters": {
        "gl": "US",
        "hl": "en-US",
        "ceid": "US:en",
        "domain": "nytimes.com",
        "engine": "google_news_publication"
    }
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "hl": [
            "The language is a 2 letter code like en or de."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

The publication token does not exist for this language and country. This response is not billable.

{
    "error": "This publication does not exist for this language and country."
}
503

Service Unavailable

Google News could not be reached or gave an unreadable answer. This response is not billable. Retry later.

{
    "error": "Google News could not be reached. Try again."
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.