Skip to main content

The Guardian API

Overview

The Guardian API source can sync data from the The Guardian

Requirements

To access the API, you will need to sign up for an API key, which should be sent with every request. Visit this link to register for an API key.

The following (optional) parameters can be provided to the connector :-


q (query)

The q (query) parameter filters the results to only those that include that search term. The q parameter supports AND, OR and NOT operators. For example, let's see if the Guardian has any content on political debates: https://content.guardianapis.com/search?q=debates

Here the q parameter filters the results to only those that include that search term. In this case, there are many results, so we might want to filter down the response to something more meaningful, specifically looking for political content published in 2014, for example: https://content.guardianapis.com/search?q=debate&tag=politics/politics&from-date=2014-01-01&api-key=test


tag

A tag is a piece of data that is used to categorise content. All Guardian content is manually categorised using these tags, of which there are more than 50,000. Use this parameter to filter results by showing only the ones matching the entered tag. See here for a list of all tags, and here for the tags endpoint documentation.


section

Use this to filter the results by a particular section. See here for a list of all sections, and here for the sections endpoint documentation.


order-by

Use this to sort the results. The three available sorting options are - newest, oldest, relevance. For enabling incremental syncs set order-by to oldest.


start_date

Use this to set the minimum date (YYYY-MM-DD) of the results. Results older than the start_date will not be shown.


end_date

Use this to set the maximum date (YYYY-MM-DD) of the results. Results newer than the end_date will not be shown. Default is set to the current date (today) for incremental syncs.


Output schema

Each content item (news article) has the following structure:-

{
"id": "string",
"type": "string"
"sectionId": "string"
"sectionName": "string"
"webPublicationDate": "string"
"webTitle": "string"
"webUrl": "string"
"apiUrl": "string"
"isHosted": "boolean"
"pillarId": "string"
"pillarName": "string"
}

The source is capable of syncing the content stream.

Setup guide

Step 1: Set up the The Guardian API connector in Airbyte

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  3. On the Set up the source page, select The Guardian API from the Source type dropdown.
  4. Enter your api_key (mandatory) and any other optional parameters as per your requirements.
  5. Click Set up source.

For Airbyte OSS:

  1. Navigate to the Airbyte Open Source dashboard.
  2. Set the name for your source (The Guardian API).
  3. Enter your api_key (mandatory) and any other optional parameters as per your requirements.
  4. Click Set up source.

Supported sync modes

The Guardian API source connector supports the following sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncNo
NamespacesNo

Performance considerations

The key that you are assigned is rate-limited and as such any applications that depend on making large numbers of requests on a polling basis are likely to exceed their daily quota and thus be prevented from making further requests until the next period begins.

Reference

Config fields reference

Field
Type
Property name
string
api_key
string
start_date
string
query
string
tag
string
section
string
end_date

Changelog

Expand to review
VersionDatePull RequestSubject
0.2.02024-09-0645195Refactor connector to manifest-only format
0.1.92024-08-3144997Update dependencies
0.1.82024-08-2444746Update dependencies
0.1.72024-08-1744208Update dependencies
0.1.62024-08-1043540Update dependencies
0.1.52024-08-0342781Update dependencies
0.1.42024-07-2042316Update dependencies
0.1.32024-07-1341878Update dependencies
0.1.22024-07-1041505Update dependencies
0.1.12024-07-1041049Migrate to poetry
0.1.02022-10-3018654🎉 New Source: The Guardian API [low-code CDK]