Skip to content

Get content (articles) for a followed feed of a customer

GET
/cms/customer/feed/content
curl --request GET \
--url 'https://api.example.com/cms/customer/feed/content?publication_id=1%2C2%2C3&page_number=1&limit=10' \
--header 'API-Key: <API-Key>' \
--header 'Authorization: Bearer <token>' \
--header 'Token: <Token>'
publication_id
required
string

Example

1,2,3

Publication IDs to filter by (comma-separated)

page_number
integer

Example

1

Page number

limit
integer

Example

10

Items per page

Category content (paginated)

Media typeapplication/json
object
total

Total items

integer
page

Current page

integer
category
Category

API representation of a category

object
id

Category ID

string format: int64
layoutTemplate

Page builder category template to render the category with (own, else nearest parent’s, else the publication’s). Only on GET /cms/category/{id}; null when none applies or the page builder is off

nullable
One of:
PageTemplateMatch

The page builder template to render a category, publication, article, author or keyword with (the layoutTemplate field of their views). For category, author, keyword and article pages, prefer their /layout endpoint (e.g. GET /cms/category/{category_id}/layout), which returns the object and this template already filled in one call. Otherwise fetch the layout with GET /cms/layout/key/{key}, or GET /cms/layout/{id} when key is null.

object
id

Layout ID of the template

integer format: int64
key

Stable key of the template; null when not set

string
nullable
name

Template name

string
matchedBy

Why this template applies, most specific first: the content type (article templates only), the category itself, a parent category, or the publication; for author and keyword templates, the author or keyword itself

string
Allowed values: article_type category parent_category publication author keyword
targetType

What the template is used for

string
Allowed values: article_type category publication author keyword
targetId

ID of the content type, category, publication, author or keyword

integer format: int64
name

Category name

string
seo_name

Seo name

string
nullable
signature

Signature

string
nullable
slug

Slug

string
nullable
typeId

Type ID or object

mixed
nullable
parentId

Parent category ID

nullable
parent

Parent object

nullable
image

Image URL

string
nullable
cover

Cover URL

string
nullable
logo

Logo URL

string
nullable
paid

Paid flag

string
nullable
objectType

PHP class name of the object

string
url

Absolute URL

string
cssCode

CSS code

string
nullable
template

Template name

string
nullable
tagline

Tagline

string
nullable
link_param

Link parameter

string
nullable
description

Description

string
nullable
metaDescription

Meta description

string
nullable
iptcCode

IPTC Media Topic code

string
nullable
order

Order

nullable
pageId

Page ID

nullable
articlesCount

Articles count

integer
nullable
allowComments

Allow comments flag

string
nullable
accessType

Access type of the category (e.g., public, restricted)

string
nullable
status

Status

string
nullable
children
Array<object> recursive
data

Array of content items

Array<object>
Content

API representation of an article/content item (v3)

object
objectType

Object PHP class name

string
id

Article ID (numeric string)

string
signature

Signature

string
nullable
url

Absolute URL

string
nullable
shorturl

Short URL

string
nullable
slug

Slug

string
nullable
contentType
ContentType

API representation of a content type

object
id

Content Type ID

name

Name

string
slug

Slug

string
editor

Editor

string
Allowed values: default quill tiptap email email_legacy html
views

Views count

integer
comments

Comments count

integer
rating

Average rating by customers

number format: float
rating_count

Total ratings count

number format: integer
preview_limit

Preview limit

integer
nullable
excludedFromGoogleSearchEngine

Excluded from search engine flag

integer
title

Title

string
nullable
firstPublished

First published date, MySQL datetime (Y-m-d H:i:s)

string
nullable
lastUpdate

Last update date, MySQL datetime (Y-m-d H:i:s)

string
nullable
categories

Categories

Array<object>
Category

API representation of a category

object
id

Category ID

string format: int64
layoutTemplate

Page builder category template to render the category with (own, else nearest parent’s, else the publication’s). Only on GET /cms/category/{id}; null when none applies or the page builder is off

nullable
One of:
PageTemplateMatch

The page builder template to render a category, publication, article, author or keyword with (the layoutTemplate field of their views). For category, author, keyword and article pages, prefer their /layout endpoint (e.g. GET /cms/category/{category_id}/layout), which returns the object and this template already filled in one call. Otherwise fetch the layout with GET /cms/layout/key/{key}, or GET /cms/layout/{id} when key is null.

object
id

Layout ID of the template

integer format: int64
key

Stable key of the template; null when not set

string
nullable
name

Template name

string
matchedBy

Why this template applies, most specific first: the content type (article templates only), the category itself, a parent category, or the publication; for author and keyword templates, the author or keyword itself

string
Allowed values: article_type category parent_category publication author keyword
targetType

What the template is used for

string
Allowed values: article_type category publication author keyword
targetId

ID of the content type, category, publication, author or keyword

integer format: int64
name

Category name

string
seo_name

Seo name

string
nullable
signature

Signature

string
nullable
slug

Slug

string
nullable
typeId

Type ID or object

mixed
nullable
parentId

Parent category ID

nullable
parent

Parent object

nullable
image

Image URL

string
nullable
cover

Cover URL

string
nullable
logo

Logo URL

string
nullable
paid

Paid flag

string
nullable
objectType

PHP class name of the object

string
url

Absolute URL

string
cssCode

CSS code

string
nullable
template

Template name

string
nullable
tagline

Tagline

string
nullable
link_param

Link parameter

string
nullable
description

Description

string
nullable
metaDescription

Meta description

string
nullable
iptcCode

IPTC Media Topic code

string
nullable
order

Order

nullable
pageId

Page ID

nullable
articlesCount

Articles count

integer
nullable
allowComments

Allow comments flag

string
nullable
accessType

Access type of the category (e.g., public, restricted)

string
nullable
status

Status

string
nullable
children
Array<object> recursive
contents

Contents (html string or key-value pair of html, js, and css)

One of:

HTML string

string
content_length

Content length

integer
summary

Summary

string
nullable
introduction

Introduction

string
nullable
premium

Premium flag

nullable
free

Free flag

nullable
credits

Credits

nullable
authors

Authors

Array<object>
Author

API representation of an author

object
id

Author ID (numeric string)

string
layoutTemplate

Page builder author template linked to this author. Only on GET /cms/author/{id}; null when none is linked (use your default template) or the page builder is off

nullable
One of:
PageTemplateMatch

The page builder template to render a category, publication, article, author or keyword with (the layoutTemplate field of their views). For category, author, keyword and article pages, prefer their /layout endpoint (e.g. GET /cms/category/{category_id}/layout), which returns the object and this template already filled in one call. Otherwise fetch the layout with GET /cms/layout/key/{key}, or GET /cms/layout/{id} when key is null.

object
id

Layout ID of the template

integer format: int64
key

Stable key of the template; null when not set

string
nullable
name

Template name

string
matchedBy

Why this template applies, most specific first: the content type (article templates only), the category itself, a parent category, or the publication; for author and keyword templates, the author or keyword itself

string
Allowed values: article_type category parent_category publication author keyword
targetType

What the template is used for

string
Allowed values: article_type category publication author keyword
targetId

ID of the content type, category, publication, author or keyword

integer format: int64
url

URL to the author page

string
name

Author name

string
image

Image URL

string
nullable
image_transforms

Available image transformations in different sizes

Array<object>
object
x

Width in pixels (numeric string)

string
y

Height in pixels (numeric string)

string
url

URL to the transformed image; empty string when the author has no image

string
cover

Cover image URL

string
nullable
email

Author email

string
nullable
department

Department

string
nullable
editorialName

Editorial name (slug)

string
nullable
biography

Short biography

string
nullable
description

Full description (HTML)

string
nullable
name_latin

Name in latin characters

string
nullable
country

Country code or name

string
nullable
googlePlus

Google+ profile (legacy)

string
nullable
twitter

Twitter handle (without @)

string
nullable
facebook

Facebook username

string
nullable
linkedin

LinkedIn profile

string
nullable
instagram

Instagram handle

string
nullable
objectType

Class name of the object

string
replacedWith

If this author was replaced, id of replacement

nullable
source

Source, if present

string
nullable
sponsor

Sponsor

nullable
One of:
Sponsor

API representation of a sponsor

object
id

Sponsor ID (numeric string)

string
url

URL to the sponsor page

string
name

Sponsor name

string
image

Image URL

string
nullable
attachments

Attachments

Array<object>
nullable
Attachment

API representation of an attachment (images, video, files)

object
id

Attachment ID (numeric string)

string
name

Name

string
nullable
description

Description

string
nullable
type

Type (image|video|file)

string
url

Public URL

string
nullable
width

Width in pixels

integer format: int32
height

Height in pixels

integer format: int32
focal

Focal point as “x% y%”

string
nullable
transforms

Transforms (list of available image transforms)

Array<object>
object
x

Width in pixels (numeric string)

string
y

Height in pixels (numeric string)

string
url

URL of the transformed image

string
urls

Additional urls per transform

object
url_medium

Search title

string
url_highres

Search description

string
url_original

Social title

string
video

Video object when type is video

nullable
One of:
Video

API representation of a video

object
id

Video ID (numeric string)

string
title

Title

string
url

URL

string
duration

Duration in seconds (numeric string)

string
number

Episode number (numeric string)

string
nullable
status

Status

string
showId

Show ID (numeric string)

string
nullable
showName

Show name

string
nullable
showUrl

Show URL

string
nullable
brief

Brief

string
nullable
thumbnail

Thumbnail URL

string
nullable
thumbnailPlay

ThumbnailPlay URL

string
nullable
filename

Filename/URL

string
nullable
publishDate

Publish date

string
nullable
views

Views (numeric string)

string
publish

Publish flag

nullable
formats

Formats

Array<object>
nullable
Video_Format

API representation of a video format

object
format

Format

string
filename

Filename/URL

string
cdnPath

CDN path

string
nullable
mime

MIME type

string
duration

Duration in seconds

integer format: int32
nullable
inline_attachments

Inline attachments

Array<object>
nullable
Attachment

API representation of an attachment (images, video, files)

object
id

Attachment ID (numeric string)

string
name

Name

string
nullable
description

Description

string
nullable
type

Type (image|video|file)

string
url

Public URL

string
nullable
width

Width in pixels

integer format: int32
height

Height in pixels

integer format: int32
focal

Focal point as “x% y%”

string
nullable
transforms

Transforms (list of available image transforms)

Array<object>
object
x

Width in pixels (numeric string)

string
y

Height in pixels (numeric string)

string
url

URL of the transformed image

string
urls

Additional urls per transform

object
url_medium

Search title

string
url_highres

Search description

string
url_original

Social title

string
video

Video object when type is video

nullable
One of:
Video

API representation of a video

object
id

Video ID (numeric string)

string
title

Title

string
url

URL

string
duration

Duration in seconds (numeric string)

string
number

Episode number (numeric string)

string
nullable
status

Status

string
showId

Show ID (numeric string)

string
nullable
showName

Show name

string
nullable
showUrl

Show URL

string
nullable
brief

Brief

string
nullable
thumbnail

Thumbnail URL

string
nullable
thumbnailPlay

ThumbnailPlay URL

string
nullable
filename

Filename/URL

string
nullable
publishDate

Publish date

string
nullable
views

Views (numeric string)

string
publish

Publish flag

nullable
formats

Formats

Array<object>
nullable
Video_Format

API representation of a video format

object
format

Format

string
filename

Filename/URL

string
cdnPath

CDN path

string
nullable
mime

MIME type

string
duration

Duration in seconds

integer format: int32
nullable
files

Files

Array<object>
nullable
Attachment

API representation of an attachment (images, video, files)

object
id

Attachment ID (numeric string)

string
name

Name

string
nullable
description

Description

string
nullable
type

Type (image|video|file)

string
url

Public URL

string
nullable
width

Width in pixels

integer format: int32
height

Height in pixels

integer format: int32
focal

Focal point as “x% y%”

string
nullable
transforms

Transforms (list of available image transforms)

Array<object>
object
x

Width in pixels (numeric string)

string
y

Height in pixels (numeric string)

string
url

URL of the transformed image

string
urls

Additional urls per transform

object
url_medium

Search title

string
url_highres

Search description

string
url_original

Social title

string
video

Video object when type is video

nullable
One of:
Video

API representation of a video

object
id

Video ID (numeric string)

string
title

Title

string
url

URL

string
duration

Duration in seconds (numeric string)

string
number

Episode number (numeric string)

string
nullable
status

Status

string
showId

Show ID (numeric string)

string
nullable
showName

Show name

string
nullable
showUrl

Show URL

string
nullable
brief

Brief

string
nullable
thumbnail

Thumbnail URL

string
nullable
thumbnailPlay

ThumbnailPlay URL

string
nullable
filename

Filename/URL

string
nullable
publishDate

Publish date

string
nullable
views

Views (numeric string)

string
publish

Publish flag

nullable
formats

Formats

Array<object>
nullable
Video_Format

API representation of a video format

object
format

Format

string
filename

Filename/URL

string
cdnPath

CDN path

string
nullable
mime

MIME type

string
duration

Duration in seconds

integer format: int32
nullable
videos

Videos

Array<object>
nullable
Attachment

API representation of an attachment (images, video, files)

object
id

Attachment ID (numeric string)

string
name

Name

string
nullable
description

Description

string
nullable
type

Type (image|video|file)

string
url

Public URL

string
nullable
width

Width in pixels

integer format: int32
height

Height in pixels

integer format: int32
focal

Focal point as “x% y%”

string
nullable
transforms

Transforms (list of available image transforms)

Array<object>
object
x

Width in pixels (numeric string)

string
y

Height in pixels (numeric string)

string
url

URL of the transformed image

string
urls

Additional urls per transform

object
url_medium

Search title

string
url_highres

Search description

string
url_original

Social title

string
video

Video object when type is video

nullable
One of:
Video

API representation of a video

object
id

Video ID (numeric string)

string
title

Title

string
url

URL

string
duration

Duration in seconds (numeric string)

string
number

Episode number (numeric string)

string
nullable
status

Status

string
showId

Show ID (numeric string)

string
nullable
showName

Show name

string
nullable
showUrl

Show URL

string
nullable
brief

Brief

string
nullable
thumbnail

Thumbnail URL

string
nullable
thumbnailPlay

ThumbnailPlay URL

string
nullable
filename

Filename/URL

string
nullable
publishDate

Publish date

string
nullable
views

Views (numeric string)

string
publish

Publish flag

nullable
formats

Formats

Array<object>
nullable
Video_Format

API representation of a video format

object
format

Format

string
filename

Filename/URL

string
cdnPath

CDN path

string
nullable
mime

MIME type

string
duration

Duration in seconds

integer format: int32
nullable
keywords

Keywords

Array<object>
Keyword

API representation of a keyword

object
keywordId

Keyword ID (numeric string)

string
layoutTemplate

Page builder keyword template linked to this keyword. Only on GET /cms/keyword/{id}; null when none is linked (use your default template) or the page builder is off

nullable
One of:
PageTemplateMatch

The page builder template to render a category, publication, article, author or keyword with (the layoutTemplate field of their views). For category, author, keyword and article pages, prefer their /layout endpoint (e.g. GET /cms/category/{category_id}/layout), which returns the object and this template already filled in one call. Otherwise fetch the layout with GET /cms/layout/key/{key}, or GET /cms/layout/{id} when key is null.

object
id

Layout ID of the template

integer format: int64
key

Stable key of the template; null when not set

string
nullable
name

Template name

string
matchedBy

Why this template applies, most specific first: the content type (article templates only), the category itself, a parent category, or the publication; for author and keyword templates, the author or keyword itself

string
Allowed values: article_type category parent_category publication author keyword
targetType

What the template is used for

string
Allowed values: article_type category publication author keyword
targetId

ID of the content type, category, publication, author or keyword

integer format: int64
name

Name

string
url

URL

string
slug

Slug

string
description

Description

string
nullable
articlesCount

Articles count

integer
replacedWith

If this keyword was replaced, id of replacement

nullable
display_name

Display name

string
nullable
translations

Translations

nullable
collection_id

Collection id

integer
nullable
image

Image URL

string
nullable
related
Array<object> recursive
language

Language of the article, as a two- or three-letter code: the one set in its Translations panel, else its primary category’s publication locale (fr-FR gives fr). Empty when neither is known. Missing from arrays cached before this field was added, until they are rebuilt.

string
nullable
translations

The published translations of this article (the other articles in its language group), sorted by language; an empty array when it has none. Scheduled translations appear once their publish date has passed. Missing from arrays cached before this field was added, until they are rebuilt.

Array<object>
nullable
object
id

Article ID of the translation

integer
language

Its language code

string
title

Its title

string
url

Its absolute URL

string
firstPublished

First published date, MySQL datetime (Y-m-d H:i:s)

string
lastUpdate

Last update date, MySQL datetime (Y-m-d H:i:s)

string
elements

Elements (youtube, liveblogs, polls, quiz); an empty array when the article has none

nullable
One of:
object
liveblogs

Live blogs in the article

Array<object>
nullable
LiveBlog

API representation of a liveblog

object
id

LiveBlog ID

integer format: int64
title

Title

string
start_date

Start date

string
nullable
end_date

End date

string
nullable
room_name

Websocket room name

string
preview

Preview messages

Array<object>
LiveBlogMessage

API representation of a liveblog message

object
id

Message ID

integer format: int64
timestamp

Timestamp

string
nullable
text

Text

string
nullable
title

Title

string
nullable
minute

Minute

string
nullable
minute_additional

Additional minute value

integer format: int64
typeId

Type id

string
nullable
imageLetter

Image letter/character

string
nullable
highlight

Highlight flag

boolean
html

HTML content

string
nullable
user

User display name

string
user_thumbnail

User thumbnail URL

string
nullable
polls

Polls in the article

Array<object>
nullable
Poll

API representation of a poll

object
id

Poll ID (numeric string)

string
timestamp

Timestamp, MySQL datetime (Y-m-d H:i:s)

string
question

Question

string
choices

Choices

Array<object>
object
num

Choice number

integer
text

Choice text

string
image_url

Choice image URL (only when the choice has an image)

string
votes

Votes

integer
slug

Slug

string
category
PollCategory

API representation of a poll category

object
id

Category ID (numeric string)

string
name

Name

string
image

Image URL, or false when the poll has no image

One of:
string
results

Results, keyed by choice number, plus a total key with the total number of votes

object
total

Total number of votes

integer
key
additional properties
object
value

Number of votes

integer
percentage

Percentage of total votes, formatted with one decimal (e.g. “100.0”); the integer 0 when there are no votes

One of:
string
message

Message

string
nullable
onlyLoggedIn

Only logged in (“0” or “1”)

string
endDate

End date

string
nullable
voted

Voted (only true when voting)

boolean
voted_choice

Voted choice (only valid when voting); false when voting status is not included

One of:
integer
closed

Closed (“0” or “1”)

string
quizzes

Quizzes in the article

Array<object>
nullable
Quiz

API representation of a quiz

object
id

Quiz ID

integer format: int64
name

Name

string
timestamp

Timestamp

string
image

Image

string
coverPicture

Cover picture

string
description

Description

string
share

Share

string
template

Template

string
allow_form

Allow form

string
introduction_message

Introduction message

string
thankyou_message

Thankyou message

string
terms

Terms

string
status

Status

string
questions

Questions

Array<object>
QuizQuestion

API representation of a quiz question

object
id

Question ID

integer format: int64
title

Title

string
resultText

Result text

string
image

Image

string
choices

Choices

Array<object>
QuizAnswer

API representation of a quiz answer

object
id

Answer ID

integer format: int64
answer

Answer text

string
letter

Letter

string
image

Image

string
correct

Correct

boolean
points

Points

integer
votes

Votes

integer
results

Results

Array<object>
QuizResult

API representation of a quiz result

object
id

Result ID

integer format: int64
result

Result

string
image

Image

string
letter

Letter

string
resultText

Result text

string
share

Share

string
twitterShare

Twitter share

string
minimum

Minimum

integer
maximum

Maximum

integer
votes

Votes

integer
youtube

YouTube video IDs in the article

Array<string>
nullable
seo

SEO object

object
search_title

Search title

string
search_description

Search description

string
social_title

Social title

string
social_description

Social description

string
social_image

Social image URL

string
time_to_read

Time to read (seconds)

integer
access_control

Access control enabled

boolean
access_allowed

Access allowed

boolean
status

Status

nullable
cached

Cached flag

boolean

Example

{
"category": {
"layoutTemplate": {
"id": 31,
"key": "opinion-article",
"name": "Opinion article",
"matchedBy": "article_type",
"targetType": "article_type",
"targetId": 14
}
},
"data": [
{
"id": "2906598",
"contentType": {
"editor": "default"
},
"firstPublished": "2026-10-13 14:02:05",
"lastUpdate": "2026-10-13 14:02:05",
"categories": [
{
"layoutTemplate": {
"id": 31,
"key": "opinion-article",
"name": "Opinion article",
"matchedBy": "article_type",
"targetType": "article_type",
"targetId": 14
}
}
],
"authors": [
{
"id": "1073916",
"layoutTemplate": {
"id": 31,
"key": "opinion-article",
"name": "Opinion article",
"matchedBy": "article_type",
"targetType": "article_type",
"targetId": 14
},
"image_transforms": [
{
"x": "200",
"y": "100"
}
]
}
],
"sponsor": {
"id": "1"
},
"attachments": [
{
"id": "110586",
"transforms": [
{
"x": "200",
"y": "100"
}
],
"video": {
"id": "4903",
"duration": "171",
"number": "1",
"showId": "2",
"views": "0"
}
}
],
"inline_attachments": [
{
"id": "110586",
"transforms": [
{
"x": "200",
"y": "100"
}
],
"video": {
"id": "4903",
"duration": "171",
"number": "1",
"showId": "2",
"views": "0"
}
}
],
"files": [
{
"id": "110586",
"transforms": [
{
"x": "200",
"y": "100"
}
],
"video": {
"id": "4903",
"duration": "171",
"number": "1",
"showId": "2",
"views": "0"
}
}
],
"videos": [
{
"id": "110586",
"transforms": [
{
"x": "200",
"y": "100"
}
],
"video": {
"id": "4903",
"duration": "171",
"number": "1",
"showId": "2",
"views": "0"
}
}
],
"keywords": [
{
"keywordId": "408663",
"layoutTemplate": {
"id": 31,
"key": "opinion-article",
"name": "Opinion article",
"matchedBy": "article_type",
"targetType": "article_type",
"targetId": 14
}
}
],
"language": "en",
"translations": [
{
"id": 2906648,
"language": "fr",
"firstPublished": "2026-10-13 14:02:05",
"lastUpdate": "2026-10-13 14:02:05"
}
],
"elements": {
"polls": [
{
"id": "7",
"timestamp": "2024-12-17 16:32:19",
"choices": [
{
"num": 1,
"text": "I like this"
}
],
"category": {
"id": "1"
},
"image": false,
"results": {
"1": {
"value": 16,
"percentage": "100.0"
},
"2": {
"value": 0,
"percentage": "0.0"
},
"total": 16
},
"onlyLoggedIn": "0",
"voted_choice": false,
"closed": "0"
}
]
}
}
]
}