Import a JSON Feed

Add article content via JSON.

C
Written by Customer Success
Updated over a week ago

If you have your articles' feed in JSON format instead of as an RSS feed, you can still add them to your MAZ app. To add a JSON feed to incorporate article content into your mobile app, get started here!

  1. Navigate to the Section you would like to add the JSON feed.

  2. Click on +Content, +Feed, then +JSON.

3. Enter the following information in their respective fields:

  • Name (Internal facing)

  • Feed URL

  • Title (External)

  • Subtitle (External)

  • Description (External)

  • PDF Upload*

    *PDF Upload Note: If the JSON feed is a web-based replica of a printed edition/issue of a magazine, you can upload the PDF for the edition/issue here to allow compliance with AAM circulation regulations for digital editions.

4. In the next form you see, fill in the metadata for the content menu you are adding to your app and save the form. For example, access, cover date, release date, download options etc.

Find our JSON feed specifications below!

Main Feed

{
  “modules”: [
    {
      "id": ,
      “title”: ,
      "articles": [
        {
          "id": <unique identifier of article in string>,
          "title": <title of the article>,
          "published": <time in epoch in seconds>,
          "updatedAt": <time in epoch in seconds>,
          "shortURL": <article’s source URL>,
          "links": {
            "self": {
              "href": <relative path of the stories JSON>
            }
          },
          "image": {
            "url": <URL of cover image>,
          },
        },
        .
        .
        .
      ]
    },
    .
    .
    .
  ]
}


NOTE: Please see the example for href: <relative path of the stories JSON> below:

href = "a/b/stories/(id)"

Example JSON Feed URL: http://host.com/a/b/c.json

Article Feed

{
  "title": ,
  "label": <Label appears in the top right(shouldn't be too long)>,
  "deck": <Description of the article for Template>,
  "byline": <Name of the Author>,
  "html": <HTML snippet of the content(Don't insert the full HTML page here. Only the content.)>,
  "image": {
    “url": <URL for the Hero or top Image>,
    "credit": <credits for image>
  },
  "body": {
    "lede": {
       "video": <HTML for the embedded inline video player if any>
“type”: “videoEmbed”,
“html”: “<iframe width=‘560’ height=‘315’ src=‘https://www.youtube.com/embed/_MfXYPBCDw’ frameborder=‘0’ allowfullscreen></iframe>”
    }
  }
}

Note: Please ensure the Embed Code for the video should be responsive.

If you don't have an articles' JSON but would like to add video/audio content through JSON format, you can choose to add a Media JSON feed in our dashboard. Learn More here!

Did this answer your question?