Skip to content

How-to guides

Data feeds

A data feed is a web address that answers with JSON. Mestra reads it and uses the fields you choose to pick which dynamic variant plays. Mestra has no data source of its own. You connect yours.

Add a feed

  1. Open Settings > Integrations > Data feeds > Open data feeds.
  2. Select Add a feed.
  3. Fill in the form:
    • Name: what you’ll call it.
    • Use it for: Signals for a screen (a few values) or A table of rows (a whole content table).
    • Address: an https address. It can include screen placeholders (below).
    • Keys: any keys your feed needs. Each has a name and a value.
    • Refresh every (seconds): how often to ask again. The shortest is 60.
    • Oldest answer to use (seconds): how long to keep using the last good answer if the feed stops working.
    • Fields: for each value you want, its Path in the answer and the Signal name to give it.
  4. Select Save, then Test.

Placeholders

Put a placeholder in the address and Mestra fills it in for each screen:

Placeholder Fills in
{lat} The screen’s latitude
{lon} The screen’s longitude
{postcode} The screen’s postcode
{city} The screen’s city
{screen_id} The screen’s ID

They can go in the path or the query, not in the host. A screen’s location and details come from your screen network. If a screen doesn’t have one of the facts the address needs, that screen gets no values from the feed.

What Mestra sends to your feed

Mestra asks for your address, with the screen’s values filled in, and sends your keys. That’s all. It never sends your keys to a screen. If your address uses {lat}, {lon} or {postcode}, the screen’s location goes to your feed, so only use a feed you trust with it.

Keys

Keys are sent as request headers, and Mestra keeps them encrypted. After you save, Mestra shows only the last few characters. To change a key, enter its value again. Saved keys only go to the address they were saved for. If you move the feed to a new host, enter the keys again.

Fields

A path is the route to a value in the answer, with dots between the steps. A number steps into a list. For this answer:

JSON
{ "weather": [ { "main": "Rain" } ], "main": { "temp": 18.4 } }

weather.0.main is Rain and main.temp is 18.4. Text, numbers and true or false work. A signal name uses lower case letters, digits and underscores, up to 40 characters. It can’t be a name Mestra already uses (time, day, date, screen_id, size, tags, lat, lon, city, state, postcode), and two feeds can’t use the same one.

Limits

  • Up to 20 feeds, 50 fields each and 10 keys each.
  • Answers must be JSON and under 1 MB. Mestra waits 10 seconds.
  • A feed shows Working, Failed or Not read yet. A failed one says why, such as Couldn’t reach it or Answer wasn’t JSON.

Connect a weather feed

OpenWeather

OpenWeather’s current weather API has a free plan with a key.

  1. Sign up at openweathermap.org and copy your API key.

  2. In Mestra, select Add a feed and name it Weather. Leave Use it for on Signals for a screen.

  3. Paste this into Address, with your key in place of YOUR_KEY:

    Text
    https://api.openweathermap.org/data/2.5/weather?lat={lat}&lon={lon}&units=metric&appid=YOUR_KEY

    OpenWeather takes its key in the address, not as a header. A key in the address is saved as part of the address. It isn’t encrypted like Keys, and it shows to anyone who can open the feed. Only owners can see data feeds.

  4. Set Refresh every (seconds) to 600.

  5. Add two fields:

    • Path weather.0.main, Signal weather. The kind of weather: Clear, Clouds, Rain, Drizzle, Thunderstorm, Snow and so on.
    • Path main.temp, Signal temperature. The temperature in °C.
  6. Select Save. Under the form, choose a Screen to test with (one that has a location) and select Test. You should see weather and temperature.

The Edit feed form for a feed called Weather, used for signals for a screen. It shows an OpenWeather address with the screen’s latitude and longitude as placeholders, refresh every 600 seconds, and two fields: weather.0.main named weather, and main.temp named temperature. After choosing a screen and selecting Test, it shows temperature 17.6 and weather Rain.

The Weather starter in dynamic variants looks for fields named weather and temperature, so it picks these up. It makes Rainy, Sunny, Hot and Cold variants. Words are matched without worrying about capitals, so rain matches Rain.

Open-Meteo

Open-Meteo needs no key to try. Its free service is for non-commercial use, so check their terms and plans before you use it on live screens.

  1. Name the feed Weather.

  2. Address:

    Text
    https://api.open-meteo.com/v1/forecast?latitude={lat}&longitude={lon}&current=temperature_2m,weather_code
  3. Add two fields:

    • Path current.temperature_2m, Signal temperature. The temperature in °C.
    • Path current.weather_code, Signal weather. A number: 0 and 1 clear, 61, 63 and 65 rain, 80 to 82 showers.
  4. Select Save, then Test with a screen.

Open-Meteo gives weather as a number. After you start from the Weather starter, set each variant’s weather to the numbers you want, for example 61,63,65,80,81,82 for Rainy and 0,1 for Sunny.

Try it

You don’t need to wait for the weather to test a variant.

  1. Open the campaign’s dynamic variants and go to the Check tab.
  2. In What would show now?, choose a Screen, then choose Weather rain and enter Temperature 12. The Weather control offers each variant’s condition as written. With Open-Meteo, choose the row of codes as written, such as 61,63,65,80,81,82.
  3. Select Check.

The Rainy variant shows Would show now, with the reason. Leave a value blank and Mestra uses your feed’s real answer for that screen.

Connect a price or stock feed

A price feed doesn’t need a screen, so the address has no placeholders.

Finnhub (stock prices)

  1. Get a key at finnhub.io.

  2. Add a feed called Stock price.

  3. Address (change AAPL to your symbol):

    Text
    https://finnhub.io/api/v1/quote?symbol=AAPL
  4. Under Keys, select Add a key. Set Key name to X-Finnhub-Token and Key value to your key.

  5. Add two fields:

    • Path c, Signal price. The current price.
    • Path dp, Signal change_percent. The change today, as a percent.
  6. Select Save, then Test.

Check that your data licence lets you show prices on screens, and how fresh the prices are.

Frankfurter (currency rates)

Frankfurter shows exchange rates and needs no key.

  1. Add a feed called AUD to USD.

  2. Address:

    Text
    https://api.frankfurter.dev/v2/rates?base=AUD&quotes=USD
  3. Add one field: Path 0.rate, Signal aud_usd. The answer is a list, so 0 is its first item.

  4. Select Save, then Test.

Use it in a variant

  1. In dynamic variants, pick Your own data.
  2. Choose the Data field, such as price, and how it compares: Is, Is one of, Is above, Is below or Is between.
  3. Set the number on each variant, for example price above 250.
  4. On the Check tab, try a price in What would show now? and select Check.

A table of rows

Choose A table of rows to keep a whole campaign’s content table in your own system. Give the Campaign key and the address of a CSV file (or the same table as JSON). It can’t use placeholders or fields. Mestra reads it again on its refresh time and saves it as the campaign’s table, checked against the approved rules like any other.

Turn data feeds off

Turning data feeds off deletes your feeds, keys and last answers. Nothing changes in your feed’s own system.

Troubleshooting

Test says Pick a screen to test this feed. The address uses a screen placeholder and you chose No screen. Choose a screen.

Test says The feed gave no values. The screen has no location or the fact the address needs, or the feed’s last error shows instead. Choose a screen that has one.

Test says No values. A table feed was read, but it had nothing to show.

The feed says Failed. Read the reason beside it. Couldn’t reach it means the address, the key or the service. Answer wasn’t JSON means the address returned something else, often a sign-in page.

My field is missing. Check the path against the answer, step by step. Names are case sensitive.

The variant I want never shows. In What would show now?, check that the feed’s value matches the variant’s condition, such as Rain against rain,drizzle.