Retrieves a list of topics in your Content Owner Media Unit


GET /v1.0/contentsholder/topics.list


Argument Required Default Value Example Description
unit_id Required - 12345678912345 ID of your Content Owner Media Unit
offset Optional 0 9 Defines the start position for retrieving items. Use a number between 0 to 5000 for this argument.
limit Optional 10 10 The argument indicates the maximum number of items to retrieve. Use a number between 1 to 100 for this argument.


    "ok": true,
    "topics": [
            "id": "0123456",
            "title": "Sakura 2018",
            "created_at": "2018-02-06T17:46:43+00:00",
            "updated_at": "2018-02-06T17:46:43+00:00",
                "id": "1234567",
                "name": "Nordor Post",
                "status": "public",
                "signature_color": "0f0f0f",
                "header_type": "background",
                "header_position": "center",
                "copyright_owner": "Nordot Inc.",
                "default_post_expire_days": 0,
                "created_at": "2015-11-16T19:06:46+00:00",
                "updated_at": "2018-03-05T05:45:25+00:00",
                    "url": "",
                    "url_w": 400,
                    "url_h": 60,
                    "thumb_360": "",
                    "square_300": ""
                "profile_image": null,
                    "id": "0012345",
                    "name": "Nordot Post Inc.",
                    "created_at": "2015-11-16T19:02:38+00:00",
                    "updated_at": "2018-02-06T17:29:41+00:00"
                "language": "en-US",
                "timezone": "Asia/Tokyo"
    "paging": {
      "count": 10,
      "offset": 0,
      "limit": 10,
      "has_next": true

If successful, the method returns an array list of “contentsholder topics” object that meets the specified criteria. For more details, please refer to the “paging” and “contentsholder topic” objects.


Error Code Description
no_unit_id Value for "unit_id" is not specified.
invalid_unit_id Value passed for “unit_id" is invalid.
unit_not_found The Media Unit cannot be found.
invalid_offset Value passed for “offset" is invalid.
invalid_limit Value passed for “limit" is invalid.

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