Skip to main content

GNews

GNews is a news aggregation API that returns structured, up-to-date articles from thousands of sources worldwide, searchable by keyword, topic, language, and country. Nexla connects to GNews as a REST data source, letting you ingest search results and top headlines on a schedule and organize them into Nexsets for downstream analysis.

GNews icon

Power end-to-end data operations for your GNews API with Nexla. Our bi-directional GNews connector is purpose-built for GNews, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to GNews or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your GNews workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Before creating a GNews credential, you need a GNews API key. GNews uses API key authentication, and the key is sent with each request to authorize access to the API.

To obtain your GNews API key, follow these steps:

  1. Go to the GNews website and sign up for a free account. No credit card is required.

  2. Verify your email address to activate your account.

  3. Sign in and open your GNews dashboard.

  4. Locate your API key on the dashboard and copy it. You will use this value when creating your Nexla credential.

Keep your API key confidential. If it is compromised, regenerate it from your GNews dashboard. For details on request parameters, rate limits, and available endpoints, see the GNews API Documentation.

Authenticate​

Credentials required​

FieldRequiredSecretDescription
API KeyYesYesAPI key used to authenticate requests to the GNews API.

Create a credential in Nexla​

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter your GNews API key in the API Key field. This is the key you obtained from your GNews dashboard in Prerequisites. It is used to authenticate every request to the GNews API and must be kept confidential.

    If your API key is compromised, regenerate it from your GNews dashboard and update your Nexla credential with the new value.

    For detailed information about GNews authentication, request parameters, and available endpoints, see the GNews API Documentation.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the GNews connector tile, then select the credential that will be used to connect to GNews, and click Next; or, create a new GNews credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common GNews endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Search

Retrieve search. This endpoint template fetches articles from the GNews search endpoint, returning structured news results that can be filtered by keyword, language, country, and date range.

  • Data is read from the articles returned by the GNews search endpoint. Use this template when you need to collect articles matching specific search criteria for analysis, reporting, or integration purposes.

For detailed information about the search endpoint, supported query parameters, and response fields, see the GNews API Documentation.

[Rest API] List Top Headlines

Retrieve top headlines. This endpoint template fetches trending articles from the GNews top-headlines endpoint, returning the current top news based on Google News rankings.

  • Data is read from the articles returned by the GNews top-headlines endpoint. Use this template when you need to collect trending news by category, language, or country for analysis, reporting, or integration purposes.

For detailed information about the top-headlines endpoint, supported categories, and response fields, see the GNews API Documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

GNews data sources can also be manually configured to ingest data from any valid GNews API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new GNews data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.