Search newsSearch mediastack's news feed (7,500+ sources across 50+ countries in 13 languages) with every filter it offers: keywords, publishers, sections, countries, languages, a published-between range, ordering and paging. Each article comes back with its publisher, the domain it ran on and the readable names of its section, language and country.
Search recent newsSearch news published within a window that moves with the clock (today, this week, the last 7 days) counted back from the day the step runs. This is the search to put on a schedule: a fixed date range would return the same articles on every run, while this one always looks at what is new.
Get historical newsRead the archive: the news of one past day, or of a range of days, with the same filters as a live search. Use it to reconstruct how a story broke, to pull the coverage around a launch date, or to build a dataset from a period that has already passed.
Get top headlinesThe stories getting the most attention rather than the most recent ones: mediastack's popularity ranking, narrowed to a country, a section of the news, a language or a keyword. This is the front page; Search news is for going after something in particular.
Get news by publisherEverything chosen publishers are running: one masthead, or a shortlist of the trade titles and local papers that matter to you. Name them by the ids Search publishers returns, and prefix one with a minus sign to leave it out of the set instead.
Search publishersSearch the directory of publishers mediastack carries, by name, subject or country, and narrow it by section, country and language. Each result carries the id the news actions take, so this is how ‘the Australian broadcaster’ becomes abc-au.
Count newsCount how many articles match, and return the newest one. It costs a single request whether the answer is three articles or thirty thousand, so it is the cheap check to branch a workflow on: alert someone when coverage of your brand spikes, or skip the rest of the run when there is nothing new.
Compare topicsCompare how much is being written about several subjects (two to five of them) over the same period, ranked, each with its share of the combined coverage and its newest headline. Use it for share of voice against competitors, or to see which of your product lines the press is picking up.
Compare countriesTake one subject and see where in the world it is being written about: two to five countries over the same period, ranked, each with its share of the combined coverage and its newest headline. Use it to tell a local story from an international one, or to find the market a launch actually landed in.
Get top publishers for a topicFind out who is covering a subject, not just what has been written: the publishers writing about it most, ranked, each with its share of the coverage and its most recent article. Use it to build a press list, to see where a story is landing, or to pick the publishers to filter a later search down to.
