GET - All Bookmarks in a Collection

Purpose

This API is used to retrieve the details of all the bookmarks in a collection.

Request URL 

Group Bookmark

https://mail.zoho.com/api/links/groups/<groupid>/collections/<collectionId>

Personal Bookmark

https://mail.zoho.com/api/links/me/collections/<collectionId>

Request Parameters

ParameterData TypeAllowed ValuesDescription
GroupID*Long The unique identifier used for groups in the organization
collectionID*Long The unique identifier used for each bookmark collection
limitInteger 

1 - 499

The number of bookmarks that you would like to retrieve
afterInteger 1 - maximum number of bookmarksThe bookmark number from which the retrieval has to be done
fieldsString
  • title
  • summary
  • link
  • linkMetaInfo
  • collectionName

(separated by comma)

The details associated with the bookmark that you wish to retrieve.
(If no field is entered, all the details will be retrieved.)

* - Mandatory parameters

Response Codes

Please refer Response Codes.

Sample Response


				{
  "status": {
    "code": 200,
    "description": "success"
  },
  "data": {
    "pagination": {
      "next": "http://mail.zoho.com/api/links/groups/36902612/collections/2866449000001749004?after=3caf3600-b5f4-1d4c-9a59-0cc47ab0a8cc&limit=20"
    },
    "list": [
      {
        "namespaceId": "36902612",
        "entityId": "2866449000001798007",
        "collectionId": "2866449000001749004",
        "collectionName": "Tools",
        "title": "How to start a blog",
        "summary": "Pointers to write a good blog",
        "link": "https://blog.hubspot.com/marketing/how-to-start-a-blog",
        "linkMetaInfo": {
          "linkFavIconUrl": "https://blog.hubspot.com/marketing/how-to-start-a-blog",
          "linkTitle": "https://blog.hubspot.com/marketing/how-to-start-a-blog",
          "linkDescription": "https://blog.hubspot.com/marketing/how-to-start-a-blog",
          "linkImage": "https://blog.hubspot.com/marketing/how-to-start-a-blog/blog.png"
        },
        "isFavorite": "false"
      },
      {
        "namespaceId": "36902612",
        "entityId": "2866449000001814006",
        "collectionId": "2866449000001749005",
        "collectionName": "Reference",
        "title": "Content Marketing",
        "summary": "https://digitalmarketinginstitute.com/blog/2018-01-15-5-essential-tips-for-a-successful-content-marketing-strategy",
        "link": "https://digitalmarketinginstitute.com/blog/2018-01-15-5-essential-tips-for-a-successful-content-marketing-strategy",
        "linkMetaInfo": {
          "linkTitle": "https://digitalmarketinginstitute.com/blog/2018-01-15-5-essential-tips-for-a-successful-content-marketing-strategy",
          "linkDescription": "https://digitalmarketinginstitute.com/blog/2018-01-15-5-essential-tips-for-a-successful-content-marketing-strategy"
        },
        "isFavorite": "false"
      }
    ]
  }
}