List Articles - Placewise API

Request

Query Params

status

enum<string>

optional

When present, only records of given status will be returned

Allowed values:

draftpublishedunpublished

Default:

null

Example:

published

locale

string

optional

Context of the query, used for example in sorting

Example:

en

publication_status

string

optional

When present, only records of given publication status will be returned

Example:

published

search

string

optional

When present, only records with pharse in title, slug, headline

Example:

hello

excluded_publication_status

string

optional

When present, only records with publication status different than given will be returned

Example:

expired

tag_ids[]

array[integer]

optional

When present, only records having one of specified tags are returned

Example:

["1","2"]

category_ids[]

array[integer]

optional

Example:

["1","2"]

per_page

integer

optional

Number of results to be returned per request. See: API Pagination

page_no

integer

optional

Number of results page. See: API Pagination

>= 1

Default:

1

sort_by[]

string

optional

See: Sorting params

Default:

id

sort_directions[]

enum<string>

optional

See: Sorting params

Allowed values:

ASCDESC

Default:

DESC

Examples:

ASCDESC

with_archived

boolean

optional

When true, also archived record will be treated as accessible

Default:

false

only_archived

boolean

optional

When true, only archived record will be treated as accessible

Default:

false

Header Params

Content-Type

enum<string>

required

Details

Allowed value:

application/json

Default:

application/json

X-User-Agent

string

required

Arbitrary identifier of your client. Details

Default:

X-Product-Name

string

required

API Product for API context. Details

Default:

X-Loyalty-Club-Slug

string

required

LoyaltyClub for API context. Details

Default:

X-Customer

string

required

Customer for API context. Details

Default:

Authorization

string

required

Member or User Authorization.

Default:

Bearer {{_OAUTH_TOKEN}}

X-Client-Authorization

string

optional

Default:

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request GET 'https://api.mpc.dev.placewise.com/v1/content/management/articles?status=published&locale=en&publication_status=published&search=hello&excluded_publication_status=expired&tag_ids[]=1&tag_ids[]=2&category_ids[]=1&category_ids[]=2&per_page=&page_no=1&sort_by[]=id&sort_directions[]=DESC&with_archived=false&only_archived=false' \
--header 'X-User-Agent;' \
--header 'X-Product-Name;' \
--header 'X-Loyalty-Club-Slug;' \
--header 'X-Customer;' \
--header 'Authorization;' \
--header 'X-Client-Authorization: '

Responses

🟢200OK

application/json

Body

articles

array[object (Article) {27}]

required

id

integer <uint64>

read-onlyrequired

Example:

1

customer_id

integer <uint64>

read-onlyrequired

Customer the record is assigned to

Example:

447

locales

required

products

required

status

enum<string>

required

Determines visibility in Public API

Allowed values:

draftpublishedunpublished

Example:

published

visible_since

required

visible_until

required

visible_in_list

boolean

required

Should record be returned on lists of CMS Public API

Default:

true

Example:

true

topic_relevant_until

required

Date until the topic of article is "relevant" to users

sorting_priority

integer

required

Priority of the record during sorting in CMS Public API. Currently read-only.

Example:

0

title

required

slug

required

teaser

required

body

required

headline

required

published_at

required

Article's publication date presented in CMS Public API. By default, visible_since is returned

image

required

Must be uploaded as a file of type: cms_article_image

url

string

required

Address of the entity page on website

Example:

path/to/:id

prototype_id

required

ContentPrototype that serves as a master for this record. Manually it can be only unset

publication_status

enum<string>

read-onlyrequired

Visibility status of the record in CMS Public API that takes into the consideration status, visible_since and visible_until dates

Allowed values:

publisheddraftexpiredscheduled

Example:

published

external_master

string

required

When present, the record is being synced from given external source

Example:

scraper

us_legacy_data

object | null

required

tag_ids

required

category_ids

array[integer]

required

created_at

string <date-time>

read-onlyrequired

Time of record creation

Example:

2022-11-05T16:25:58.099512Z

updated_at

string <date-time>

read-onlyrequired

Time of the last record update

Example:

2022-11-15T16:25:58.099512Z

archived_at

required

pagination_info

object (PaginationInfo) | null

read-onlyrequired

count

integer

read-onlyrequired

Actual number of results returned in request

Example:

1000

total_count

integer

required

Number of all available results

>= 1

Example:

2050

per_page

integer

read-onlyrequired

Number of results returned per request

Example:

1000

total_pages

integer

read-onlyrequired

Number of all available pages

Example:

3

current_page

integer

read-onlyrequired

Example:

1

next_page

integer | null

read-onlyrequired

Next available page (null when it's a last page)

Example:

2

prev_page

integer | null

read-onlyrequired

Next available page (null when it's a first page)

Example:

null

is_first_page

boolean

read-onlyrequired

Example:

true

is_last_page

boolean

read-onlyrequired

Example:

false

is_out_of_range

boolean

read-onlyrequired

Is given per_page param out of range?

Example:

false

offset

integer

read-onlyrequired

Example:

0

Example

{
    "articles": [
        {
            "id": 1,
            "customer_id": 447,
            "locales": [
                "en"
            ],
            "products": [
                "website"
            ],
            "status": "draft",
            "visible_since": "2022-11-09T16:25:58.099512Z",
            "visible_until": "2022-11-15T16:25:58.099512Z",
            "visible_in_list": true,
            "topic_relevant_until": "2022-11-09T16:25:58.099512Z",
            "sorting_priority": 0,
            "title": {
                "en": "Text"
            },
            "slug": {
                "en": "Text"
            },
            "teaser": {
                "en": "Text"
            },
            "body": {
                "en": "Text"
            },
            "headline": {
                "en": "Text"
            },
            "published_at": "2022-11-09T16:25:58.099512Z",
            "image": {
                "url": "https://example.com/image.png",
                "identifier": "1",
                "mime_type": "image/jpeg",
                "created_at": "2022-11-09T15:46:00.252860Z",
                "updated_at": "2022-11-09T15:46:00.252860Z",
                "image_details": {
                    "width": 1,
                    "height": 1
                }
            },
            "url": "path/to/:id",
            "prototype_id": 1,
            "publication_status": "published",
            "external_master": "scraper",
            "us_legacy_data": {},
            "tag_ids": [
                1
            ],
            "category_ids": [
                0
            ],
            "created_at": "2022-11-05T16:25:58.099512Z",
            "updated_at": "2022-11-15T16:25:58.099512Z",
            "archived_at": "2022-11-15T16:25:58.099512Z"
        }
    ],
    "pagination_info": {
        "count": 1000,
        "total_count": 2050,
        "per_page": 1000,
        "total_pages": 3,
        "current_page": 1,
        "next_page": 2,
        "prev_page": null,
        "is_first_page": true,
        "is_last_page": false,
        "is_out_of_range": false,
        "offset": 0
    }
}