Skip to content

Most read articles

GET
/cms/publication/{publication_id}/content/mostread/{type}
publication_id
required
integer
type
required

Type of most-read list

string
Allowed values: periodic_summarized past1 past1_limited past7 past7_limited past30 past30_limited
page_number
required
integer

List of articles

object
page
integer
data
Array<object>
Content

API representation of an article/content item (v3)

object
objectType

Object PHP class name

string
id

Article ID

integer format: int64
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 email 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
excludedFromGoogleSearchEngine

Excluded from search engine flag

integer
title

Title

string
nullable
firstPublished

First published date

string format: date-time
nullable
lastUpdate

Last update date

string format: date-time
nullable
categories

Categories

Array<object>
Category

API representation of a category

object
id

Category ID

integer format: int64
name

Category name

string
signature

Signature

string
nullable
slug

Slug

string
nullable
typeId

Type ID or object

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

integer
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
order

Order

nullable
pageId

Page ID

nullable
articlesCount

Articles count

integer
nullable
allowComments

Allow comments flag

boolean
nullable
accessType

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

string
nullable
status

Status

string
nullable
children
Array<object> recursive
contents
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

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

integer
y

Height in pixels

integer
url

URL to the transformed image

string format: uri
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
One of:
Sponsor

API representation of a sponsor

object
id

Sponsor ID

integer format: int64
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

integer format: int64
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

integer format: int32
y

Height in pixels

integer format: int32
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
One of:
Video

API representation of a video

object
id

Video ID

integer format: int64
title

Title

string
url

URL

string
duration

Duration in seconds

integer format: int64
number

Episode number

integer format: int64
nullable
status

Status

string
showId

Show ID

integer format: int64
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

integer format: int64
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

integer format: int64
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

integer format: int32
y

Height in pixels

integer format: int32
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
One of:
Video

API representation of a video

object
id

Video ID

integer format: int64
title

Title

string
url

URL

string
duration

Duration in seconds

integer format: int64
number

Episode number

integer format: int64
nullable
status

Status

string
showId

Show ID

integer format: int64
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

integer format: int64
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

integer format: int64
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

integer format: int32
y

Height in pixels

integer format: int32
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
One of:
Video

API representation of a video

object
id

Video ID

integer format: int64
title

Title

string
url

URL

string
duration

Duration in seconds

integer format: int64
number

Episode number

integer format: int64
nullable
status

Status

string
showId

Show ID

integer format: int64
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

integer format: int64
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

integer format: int64
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

integer format: int32
y

Height in pixels

integer format: int32
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
One of:
Video

API representation of a video

object
id

Video ID

integer format: int64
title

Title

string
url

URL

string
duration

Duration in seconds

integer format: int64
number

Episode number

integer format: int64
nullable
status

Status

string
showId

Show ID

integer format: int64
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

integer format: int64
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

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
elements

Elements (youtube, liveblogs, polls, quiz)

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

integer format: int64
timestamp

Timestamp

string
question

Question

string
choices

Choices

Array<string>
votes

Votes

integer
slug

Slug

string
category
PollCategory

API representation of a poll category

object
id

Category ID

integer format: int64
name

Name

string
image

Image

results

Results

Array<object>
object
value

Number of votes

integer format: int64
percentage

Percentage of total votes

number format: float
message

Message

string
onlyLoggedIn

Only logged in

integer
endDate

End date

string
nullable
voted

Voted

boolean
voted_choice

Voted choice

integer
closed

Closed

integer
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
total
integer