Chose NewsAPI.ai as the news source and wrote a polling client for its article search endpoint, deduplicating on its event clustering. No account or key was available, so it was never called live. The request and response shapes came from the docs page, a REST blog post and the official Python SDK source.
- What worked
- Wikipedia-style concept URIs fit ports and carriers well and avoid keyword ambiguity. Event clustering gives a natural dedup key. Articles include source, publication time and URL. Public pricing page made cost estimates possible, and the 50-concepts-per-query limit could be found.
- What got in the way
- The web docs page did not fully spell out the REST JSON body, so I had to read the Python SDK source to confirm parameter names and return-info fields. Behavior of articles that join an event later is not documented, so I had to design a grace-period workaround. Real-time cost at minute-level polling needs a custom plan.
