Recipes

Each recipe walks through a complete task, from the first request to reading the result. For a short example of one filter, use the examples library.

Profile people and organizations

• Build a public figure profile — use the People directory to get background details, news coverage, related people and organisations, and recent articles in one response.
• Monitor a company — volume, sentiment, momentum, and which outlets and topics drive the conversation, from the Companies directory.
• Find journalists by topic — find writers who cover a subject and see where they publish.

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 — combine three industry IDs into one feed, then filter by event type and sentiment.
• 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 news dashboard with article counts — get counts for charts grouped by category, country, publication date or sentiment.
• 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.

Collect raw articles

• Collect raw articles — pull from /v1/news/raw to get articles in a basic format and process them yourself.

Next steps

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