Recipes

A recipe solves one complete task from first request to finished result, rather than demonstrating a single parameter. If you are looking for the shortest illustration of one filter, the examples library is the better place; come here when you know what you want to build.

Profile people and organizations

• Build a person dossier — the People directory plus its coverage block: who a public figure is, how they are covered, who they are associated with, and their latest news, in one call.
• Monitor a company — volume, sentiment, momentum, and which outlets and topics drive the conversation, from the Companies directory.
• Find journalists on a beat — who writes about a subject and where they publish, for PR, outreach and source discovery.

Track a sector or an event

• Track data breaches and lawsuits — chain event.type values (data-breach → lawsuit → regulatory-action) into a security incident timeline.
• Monitor automotive and EV news — the sector spans three industry classifiers; combine them into one feed, then layer event and sentiment filters.
• Track the real estate market — construction, development and REIT coverage in a single feed, with facets showing which countries drive it.

Build an interface

• Build a faceted dashboard — one faceted request returns the numbers behind a whole dashboard, including date and sentiment histograms.
• Build an autocomplete search box — search-as-you-type over the Suggest endpoints, then follow the selection into its news feed.
• Filter news by reading level — readability scores turn into a feed for language learners, a children's news app, or dense expert analysis.

Ingest at scale

• Ingest raw articles — pull from /v1/news/raw at the discovery stage and run your own parsing and enrichment.

Next steps

• Shorter, filter-by-filter snippets: Examples library
• The full parameter set behind every recipe: Parameters
• Push instead of poll: Real-time delivery