News API
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:
everythingtop_headlines
Features
| Feature | Supported? (Yes/No) | Notes |
|---|---|---|
| Full Refresh Sync | Yes | |
| Incremental Sync | No |
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
- 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 aretitle,descriptionandcontent. - (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.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 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 |