Skip to contentDevelopersPrezly website
Public feeds

JSON feed

Fields returned by a newsroom's /feed.json and how to change dates and detail.

GET https://newsroom.example.com/feed.json

The response wraps the stories in an envelope:

{
  "title": "Example Company's pressreleases",
  "count": 1,
  "link": "https://newsroom.example.com/",
  "items": [
    {
      "title": "Example Company opens a new office",
      "subtitle": "The Ghent office is the company's third in Belgium",
      "slug": "example-company-opens-a-new-office",
      "preview_image": "https://cdn.uc.assets.prezly.com/00000000-0000-0000-0000-000000000000/-/format/auto/",
      "intro": "",
      "url": "https://newsroom.example.com/example-company-opens-a-new-office",
      "modified_at": "2026-10-08 11:06:42",
      "published_at": "2026-10-08 11:06:00",
      "culture": "en",
      "language": "EN",
      "contacts": [
        { "name": "Jane Doe", "email": "press@example.com", "telephone": "+32 9 000 00 00" }
      ],
      "tags": ["Offices", "Ghent"],
      "categories": ["Company news"]
    }
  ]
}
FieldDescription
title, linkFeed name and newsroom homepage, in the feed's language.
countNumber of items in this response, not the total number of stories.
items[].slugStable identifier of the story within the newsroom.
items[].preview_imageThumbnail URL, or an empty string.
items[].introLegacy summary field. Usually empty for current stories; use subtitle.
items[].cultureLocale code of the story, such as en or nl_BE.
items[].languageUpper-case language code, such as NL.
items[].contactsPress contacts attached to the story. Empty fields are left out.
items[].tags, items[].categoriesNames. Categories use the story's language.

Dates

By default, published_at and modified_at use the format Y-m-d H:i:s in the story author's time zone, without an offset. Pass date_format with a PHP date format to change this. date_format=c returns ISO 8601 with the offset, which is the safest choice for machines:

curl --silent 'https://newsroom.example.com/feed.json?date_format=c'
{ "published_at": "2026-10-08T11:06:00+02:00" }

Full story content

scope=full replaces each item with the story's complete public JSON, the same document as Story JSON. It includes the story content and more metadata, and is considerably slower. Keep limit small when you use it.

curl --silent 'https://newsroom.example.com/feed.json?scope=full&limit=3'

JSONP

For legacy pages that cannot use CORS, callback wraps the response in a function call and returns application/javascript:

curl --silent 'https://newsroom.example.com/feed.json?callback=showStories'

Prefer a normal fetch. Feeds already allow requests from any origin.

On this page