Skip to main content

News API

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Support Level
Marketplace
Connector Version
0.2.23 (last updated 10 months ago)
Data workers used
0.2 per sync (Learn more)
Definition ID
df38991e-f35b-4af2-996d-36817f614587

Sync overview​

This source retrieves news stories from the News API. It can retrieve news stories all news stories found within the parameters chosen, or just top headlines.

Output schema​

This source is capable of syncing the following streams:

  • everything
  • top_headlines

Features​

FeatureSupported? (Yes/No)Notes
Full Refresh SyncYes
Incremental SyncNo

Performance considerations​

The News API free tier only allows 100 requests per day, and only up to 100 results per request. It is not recommended to attempt to use this source with a free tier API key.

Getting started​

Requirements​

  1. A News API key. You can get one here. It is highly recommended to use a paid tier key.

Setup guide​

The following fields are required fields for the connector to work:

  • api_key: Your News API key.
  • (optional) search_query: A search query to filter the results by. For more information on constructing a search query, see the News API documentation.
  • (optional) search_in: Fields to search in. Possible values are title, description and content.
  • (optional) sources: Sources to search in. For a list of sources, see the News API documentation.
  • (optional) domains: Domains to search in.
  • (optional) exclude_domains: Domains to exclude from the search.
  • (optional) start_date: The start date to search from.
  • (optional) end_date: The end date to search to.
  • (optional) language: The language to search in.
  • country: The country you want headlines for.
  • category: The category you want headlines for.
  • sort_by: How to sort the results.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
api_key
string
category
string
country
string
sort_by
array<string>
domains
string
end_date
array<string>
exclude_domains
string
language
array<string>
search_in
string
search_query
array<string>
sources
string
start_date

Changelog​

Expand to review
VersionDatePull RequestSubject
0.2.232025-05-2460578Update dependencies
0.2.222025-05-1059468Update dependencies
0.2.212025-04-2758520Update dependencies
0.2.202025-04-1257848Update dependencies
0.2.192025-04-0557286Update dependencies
0.2.182025-03-2956690Update dependencies
0.2.172025-03-2256009Update dependencies
0.2.162025-03-0855451Update dependencies
0.2.152025-03-0154812Update dependencies
0.2.142025-02-2254325Update dependencies
0.2.132025-02-1553850Update dependencies
0.2.122025-02-0853275Update dependencies
0.2.112025-02-0152714Update dependencies
0.2.102025-01-2552272Update dependencies
0.2.92025-01-1851783Update dependencies
0.2.82025-01-1151222Update dependencies
0.2.72024-12-2850602Update dependencies
0.2.62024-12-2150071Update dependencies
0.2.52024-12-1449214Update dependencies
0.2.42024-11-0448143Update dependencies
0.2.32024-10-2947866Update dependencies
0.2.22024-10-2847562Update dependencies
0.2.12024-08-1644196Bump source-declarative-manifest version
0.2.02024-08-1544114Refactor connector to manifest-only format
0.1.152024-08-1243908Update dependencies
0.1.142024-08-1043589Update dependencies
0.1.132024-08-0343096Update dependencies
0.1.122024-07-2742820Update dependencies
0.1.112024-07-2042285Update dependencies
0.1.102024-07-1341781Update dependencies
0.1.92024-07-1041599Update dependencies
0.1.82024-07-0941200Update dependencies
0.1.72024-07-0640802Update dependencies
0.1.62024-06-2540297Update dependencies
0.1.52024-06-2240174Update dependencies
0.1.42024-06-1238635Use Poetry, remove $parameters, make Builder compatible
0.1.32024-06-0439038[autopull] Upgrade base image to v1.2.1
0.1.22024-05-2038418[autopull] base image + poetry + up_to_date
0.1.12023-04-3025554Make manifest connector builder friendly
0.1.02022-10-2118301New source
Was this page helpful?