EverythingRelevant for websites

Put the news that matters to business owners on your website

The EverythingRelevant living mosaic, picked for your sector and town and refreshed every hour, on your own site in two lines of code. Free for business websites, accountants, trade bodies, councils and chambers.

  • No cookies, no tracking
  • Fits any width, phone to desktop
  • Light and dark
  • Every story links to its publisher

Build your feed

Choose who it's for. The feed on the right is live, and the code underneath is ready to paste once you have a key.

Look
Your code

          

Swap YOUR_KEY for the key we email you. Paste it where the feed should go: a page, a sidebar, a WordPress “Custom HTML” block, a Wix or Squarespace embed.

1

Ask for a key

Tell us your website and what you'll show. It takes two minutes.

2

We switch it on

Usually within one working day. Your key arrives by email and only works on your own domains.

3

Paste two lines

The feed updates itself every hour. Nothing to host, nothing to maintain.

Get a free key

We read every request. Tell us a little about your site so we can set the key up for it.

How you'll use it

Fair use

Your visitors' privacy: the feed sets no cookies, stores nothing on their device and doesn't track them. Pictures load from each publisher's own site, the font from everythingrelevant.co.uk, and videos play through YouTube's privacy-enhanced mode only when someone presses play. What we keep about you when you ask for a key is in our privacy notice.

Reference

The two lines

<div data-er-feed data-key="er_pub_…" data-sector="Retail & ecommerce" data-town="Leicester"></div>
<script src="https://everythingrelevant.co.uk/embed/v1.js" async></script>

Put as many feeds on a page as you like; the script loads once. The feed draws itself in its own shadow DOM, so your site's styles can't break it and it can't change your site.

Options

AttributeWhat it does
data-keyYour key. Required.
data-sectorOne of: . Leave it out for all UK business news.
data-townA town or council area for local business news, e.g. Nottingham.
data-topicsExtra topics, commas between: coffee prices, energy bills.
data-companiesCompanies to follow: Amazon, Costa. Three or more stories about one company become a story stack.
data-limitHow many stories, 12 to 60. Default 24. Readers can press “Show more”.
data-themelight (default), dark, or auto to follow the reader's device.
data-backgroundon (default) gives the feed its own white or dark panel; off sits it straight on your page.
data-titleThe heading over the feed. Default: from the sector and town.
data-chipsoff hides the filter chips (For you, Act on it, Live now, Videos…).
data-videosoff leaves news videos out.

From JavaScript

const feed = EverythingRelevant.mount(document.querySelector('#news'), {
  key: 'er_pub_…', sector: 'Hospitality & food', town: 'Leicester', limit: 24, theme: 'auto',
});
feed.update({ town: 'Derby' });   // new stories for Derby
feed.refresh();                   // fetch again now (it also refreshes itself every 10 minutes)
feed.destroy();                   // remove it

From your server (server keys)

Two read-only actions. Send your secret key in the x-er-key header; never put a server key in a web page.

curl -X POST https://aenwzysbmoewgdjhezpd.supabase.co/functions/v1/er-api/v1/feed \
  -H 'content-type: application/json' -H 'x-er-key: er_live_…' \
  -d '{"answers":{"sectors":["Hospitality & food"],"council":"Leicester"},"topics":["coffee prices"],"limit":30,"days":3}'
ActionBodyReturns
feedanswers.sectors (one sector), answers.council (town), topics, companies, places, limit 5–60, days 1–7{ items, follows, peers }, best first
watchanswers as above{ items }: news videos from the last 3 days, ranked for the sector

Each item:

Field
id, title, url, source_name, published_atThe story and where to read it. Always link to url.
snippet, image_urlThe publisher's summary and picture, when there is one.
whyOne plain-English line on why it matters to the sector.
rel, impactHow much it matters (0–3) and how: deadline, money, cost, rule, hmrc, staff, customers, competition, local, help, general.
because, kindWhat it matched (a topic, company or place) and which kind.
fig, fig_label, quote, due_date, amount, video_idThe headline number, a quote, a date to act by, money on offer, a YouTube id. They drive the smart tiles.
sourcesHow many outlets ran the same story.

Limits and errors

Website keys: 5,000 calls a day, only from your domains. Server keys: 20,000 calls a day. Answers to the same question are reused for ten minutes, and those calls are still counted. Errors come back as { "error": "…" } with 401 (key missing or wrong), 403 (the key isn't for this site or this action) or 429 (today's limit reached).