search/contentsholder/postEvents.list

Retrieves a list of events generated in connection with Stories across all Content Owner Media Units

URL

GET /v1.0/search/contentsholder/postEvents.list

Parameters

Argument Required Default Value Example Description
since Optional Null 12345678912345 Defines the start date for retrieving events. It can be specified for up to 90 days before Jan. 1st 2018 at the oldest.
cursor Optional 0 0 Defines the start position for retrieving events. Set “next_cursor” to previously retrieved value.
offset Optional 0 0 Defines the start position for retrieving items. Use a number between 0 to 1000 for this argument.Deprecated. Scheduled to be deleted on 31/Jan/2019.
limit Optional 10 10 The argument indicates the maximum number of items to retrieve. Use a number between 1 to 100 for this argument.
direction Optional desc Desc Sort order.
asc: ascending order.
desc : descending order."
unit_ids Optional - - Filter Stories by ID of your Content Owner Media Unit. You can pass parameters up to 5.

Responses

{
    "ok": true,
    "events": [
        {
            "id": "2431456019",
            "action": "deleted",
            "created_at": "2017-11-10T20:09:31+00:00",
            "post": {
                "id": "293992393838",
                "title": "",
                "subtitle": "",
                "description": "",
                "labels": [
                  {
                    "name": "sweet potate"
                  },
                  {
                    "name": "chestnut"
                  }
                ],
                "auto_labels": [
                  "Nanakkusa porridge",
                  "pumpkin"
                ],
                "thumbnail":{
                },
                "unit": {
                    "id": "1234567",
                    "name": "Nordot News",
                    "status": "public",
                    "signature_color": "0123456",
                    "header_type": "border",
                    "header_position": "center",
                    "copyright_owner": "Nordot Inc.",
                    "website_url": "https://nordot.app/",
                    "twitter_url": "https://twitter.com/nordot_jp",
                    "facebook_url": "https://www.facebook.com/nordot/",
                    "instagram_url": "",
                    "youtube_url": "",
                    "line_url": "",
                    "introduction": "",
                    "created_at": "2015-11-17T01:54:20+00:00",
                    "updated_at": "2018-03-04T23:51:02+00:00",
                    "header_image":{
                        "url": "https://nordot-res.cloudinary.com/t_thumb_360/ch/units/1234567/header_15.png",
                        "url_w": 300,
                        "url_h": 60,
                        "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/ch/units/1234567/header_15.png",
                        "square_300": "https://nordot-res.cloudinary.com/t_square_300/ch/units/1234567/header_15.png"
                    },
                    "profile_image":{
                        "url": "https://nordot-res.cloudinary.com/ch/units/1234567/profile_1.png",
                        "square_200": "https://nordot-res.cloudinary.com/t_square_200/ch/units/1234567/profile_1.png"
                    },
                    "publisher":{
                        "id": "0012345",
                        "name": "Nordot Inc.",
                        "created_at": "2015-11-17T01:52:24+00:00",
                        "updated_at": "2018-06-15T09:07:50+00:00"
                    },
                    "language": "ja-JP",
                    "timezone": "Asia/Tokyo"
                }
            }
        },
        {
            "id": "2431457102",
            "action": "created",
            "created_at": "2017-11-10T20:09:30+00:00",
            "post": {
                "id": "293934382294",
                "title": "Autumn of appetite",
                "subtitle": "",
                "description": "Autumn arrival of appetite...",
                "labels": [
                  {
                    "name": "sweet potate"
                  },
                  {
                    "name": "chestnut"
                  }
                ],
                "auto_labels": [
                  "Nanakkusa porridge",
                  "pumpkin"
                ],
                "thumbnail":{
                    "id": "111111",
                    "url": "https://nordot-res.cloudinary.com/t_thumb_360/ch/images/111111/origin_1.jpg",
                    "created_at": "2018-09-21T04:03:57+00:00",
                    "updated_at": "2018-09-21T04:03:57+00:00"
                },
                "unit":{
                    ...
                }
            }
        },
        {
            "id": "2431457352",
            "action": "updated",
            "created_at": "2017-11-10T20:09:22+00:00",
            "post": {
                "id": "293931934943",
                "title": "Autumn is the season of sports",
                "subtitle": "Sports Day",
                "description": "Why autumn? I do not know the reason is clear. Probably",
                "labels": [
                  {
                    "name": "Sports Day"
                  }
                ],
                "auto_labels": [
                  "Autumn"
                ],
                "thumbnail":{
                    "id": "111111",
                    "url": "https://nordot-res.cloudinary.com/t_thumb_360/ch/images/111111/origin_1.jpg",
                    "created_at": "2018-09-21T04:03:57+00:00",
                    "updated_at": "2018-09-21T04:03:57+00:00"
                },
                "unit":{
                    ...
                }
            }
        },
        ...
    ],
    "paging": {
        "count": 10,
        "offset": 0,
        "limit": 10,
        "has_next": true,
        "total": 665136,
        "next_cursor": "WzE0NDc0MDYxNzE0NjQsNTkyNTE0NjUwMzcwNDU0Nl0="
    }
}

The total is "10000" if there are more than 10000 records.

Errors

Error Code Description
invalid_since Value passed for “since " is invalid.
invalid_cursor Value passed for “cursor” is invalid.
invalid_offset Value passed for “offset" is invalid.
invalid_limit Value passed for “limit" is invalid.
invalid_direction Value passed for “direction" is invalid.

For other error codes, refer to the Common Errors section of this document.