News API
Sync overview
This source retrieves news stories from the News API. You can retrieve all stories matching your chosen parameters or only top headlines.
Output schema
You can sync the following streams:
everythingtop_headlines
Features
| Feature | Supported? (Yes/No) | Notes |
|---|---|---|
| Full Refresh Sync | Yes | |
| Incremental Sync | No |
Performance
The News API free tier allows 100 requests daily and up to 100 results per request. Using this source with a free-tier API key isn’t recommended.
Getting started
Requirements
- A News API key. You can get one here. A paid-tier key is strongly recommended.
Setup guide
Configure the following connector fields:
api_key: Your News API key.- (optional)
search_query: A search query for filtering results. For guidance on constructing a search query, see the News API documentation. Theeverythingstream requires at least one ofsearch_query,sourcesordomains. Otherwise, the News API rejects the request. If you only want top headlines, deselect theeverythingstream. - (optional)
search_in: Fields to search. Possible values aretitle,descriptionandcontent. - (optional)
sources: Sources to search. For available sources, see the News API documentation. - (optional)
domains: Domains to search. - (optional)
exclude_domains: Domains to exclude from the search. - (optional)
start_date: The search start date for theeverythingstream. News API free plans cover only about one month of history. - (optional)
end_date: The search end date for theeverythingstream. - (optional)
language: The search language. country: The country for your headlines.category: The category for your headlines.sort_by: How to sort the results.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.24 | 2026-10-07 | 88217 | Fix connection check failing with Bad request when search_query/sources/domains are unset; stop sending start_date/end_date to the top_headlines endpoint (not supported by News API); surface News API plan/parameter errors as config errors instead of silently ignoring them |
| 0.2.23 | 2025-05-24 | 60578 | Update dependencies |
| 0.2.22 | 2025-05-10 | 59468 | Update dependencies |
| 0.2.21 | 2025-04-27 | 58520 | Update dependencies |
| 0.2.20 | 2025-04-12 | 57848 | Update dependencies |
| 0.2.19 | 2025-04-05 | 57286 | Update dependencies |
| 0.2.18 | 2025-03-29 | 56690 | Update dependencies |
| 0.2.17 | 2025-03-22 | 56009 | Update dependencies |
| 0.2.16 | 2025-03-08 | 55451 | Update dependencies |
| 0.2.15 | 2025-03-01 | 54812 | Update dependencies |
| 0.2.14 | 2025-02-22 | 54325 | Update dependencies |
| 0.2.13 | 2025-02-15 | 53850 | Update dependencies |
| 0.2.12 | 2025-02-08 | 53275 | Update dependencies |
| 0.2.11 | 2025-02-01 | 52714 | Update dependencies |
| 0.2.10 | 2025-01-25 | 52272 | Update dependencies |
| 0.2.9 | 2025-01-18 | 51783 | Update dependencies |
| 0.2.8 | 2025-01-11 | 51222 | Update dependencies |
| 0.2.7 | 2024-12-28 | 50602 | Update dependencies |
| 0.2.6 | 2024-12-21 | 50071 | Update dependencies |
| 0.2.5 | 2024-12-14 | 49214 | Update dependencies |
| 0.2.4 | 2024-11-04 | 48143 | Update dependencies |
| 0.2.3 | 2024-10-29 | 47866 | Update dependencies |
| 0.2.2 | 2024-10-28 | 47562 | Update dependencies |
| 0.2.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 0.2.0 | 2024-08-15 | 44114 | Refactor connector to manifest-only format |
| 0.1.15 | 2024-08-12 | 43908 | Update dependencies |
| 0.1.14 | 2024-08-10 | 43589 | Update dependencies |
| 0.1.13 | 2024-08-03 | 43096 | Update dependencies |
| 0.1.12 | 2024-07-27 | 42820 | Update dependencies |
| 0.1.11 | 2024-07-20 | 42285 | Update dependencies |
| 0.1.10 | 2024-07-13 | 41781 | Update dependencies |
| 0.1.9 | 2024-07-10 | 41599 | Update dependencies |
| 0.1.8 | 2024-07-09 | 41200 | Update dependencies |
| 0.1.7 | 2024-07-06 | 40802 | Update dependencies |
| 0.1.6 | 2024-06-25 | 40297 | Update dependencies |
| 0.1.5 | 2024-06-22 | 40174 | Update dependencies |
| 0.1.4 | 2024-06-12 | 38635 | Use Poetry, remove $parameters, make Builder compatible |
| 0.1.3 | 2024-06-04 | 39038 | [autopull] Upgrade base image to v1.2.1 |
| 0.1.2 | 2024-05-20 | 38418 | [autopull] base image + poetry + up_to_date |
| 0.1.1 | 2023-04-30 | 25554 | Make manifest connector builder friendly |
| 0.1.0 | 2022-10-21 | 18301 | New source |