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"
],
"tags": [
"weather",
"weatherreport"
],
"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"
],
"tags": [
"weather",
"weatherreport"
],
"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.