Acquire
API sources
News-provider HTTP APIs with a stored credential.
Type = API. The provider secret lives under Developer → Integrations (news keys). The source row points at that credential; we do not paste the raw key on the source.
Example: GNews top headlines
Use these values in Console → PolyFeed → Sources after the credential exists.
| Field | Value |
|---|---|
| Type | API |
| Credential | Saved GNews key |
| Base URL | https://gnews.io/api/v4/ |
| Endpoint | top-headlines |
| Query parameters | q=india, lang=en |
| Language | en |
| Category | top-stories |
| Poll interval | 5 minutes |
Fields
| Field | Required | Notes |
|---|---|---|
| Credential | Yes | Saved news-provider key (e.g. GNews, NewsData). Create it on Integrations first. |
| Base URL | Yes | Provider origin + version path, e.g. https://gnews.io/api/v4/ |
| Endpoint | Yes | Path relative to base, e.g. top-headlines. |
| Query parameters | No | Name/value pairs the provider expects (q, country, lang). Do not put secrets in the URL — use the credential. |
| Language / category / poll / active | Yes | Same shared fields. Language and category also help build the internal api:// source URL. |
Test fetch shows HTTP status, a redacted request URL, and sample titles. Fix params here before you leave the source polling a bad query.
Third-party news API cost is yours. The Aevico plan fee does not include GNews or NewsData quotas.
32 articles on this site. Engineering notes on GitHub.