API Parameters
Parameters | Required | Desc |
---|---|---|
q | false | Parameter defines the query you want to search. You can use anything that you would use in a regular Google News search. |
gl | true | Parameter defines the country to use for the Google News search. It's a two-letter country code. (e.g., us for the United States (default), uk for United Kingdom, or fr for France). |
hl | true | Parameter defines the language to use for the Google News search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). |
topic_token | false | Parameter defines the Google News topic token. It is used for accessing the news results for a specific topic (e.g., "World", "Business", "Technology"). The token can be found in our JSON response or the URL of the Google News page (in the URL, it is a string of characters preceded by /topics/ ). Parameter can't be used together with q, story_token, and publication_token parameters. |
publication_token | false | Parameter defines the Google News publication token. It is used for accessing the news results from a specific publisher (e.g., "CNN", "BBC", "The Guardian"). The token can be found in our JSON response or the URL of the Google News page (in the URL, it is a string of characters preceded by /publications/ ). Parameter can't be used together with q, story_token, and topic_token parameters. |
section_token | false | Parameter defines the Google News section token. It is used for accessing the sub-section of a specific topic. (e.g., "Business -> Economy"). The token can be found in our JSON response or the URL of the Google News page (in the URL, it is a string of characters preceded by /sections/ ) Parameter can only be used in combination with topic_token or publication_token parameters. |
story_token | false | Parameter defines the Google News story token. It is used for accessing the news results with full coverage of a specific story. The token can be found in our JSON response or the URL of the Google News page (in the URL, it is a string of characters preceded by /stories/ ) Parameter can't be used together with q, topic_token, and publication_token parameters. |
so | false | Parameter defines the sorting method. Results can be sorted by relevance or by date. By default, the results are sorted by relevance. List of supported values are: 0 Relevance 1 Date Parameter can only be used in combination with story_token parameter |
Modified at 2025-03-06 10:17:15