Collection methods

Get root collections

GET https://api.raindrop.io/rest/v1/collections

Returns JSON-encoded array containing all root collections

200

{
  "result": true,
  "items": [
    {
      "_id": 8492393,
      "access": {
        "level": 4,
        "draggable": true
      },
      "collaborators": {
        "$id": "5dc1759a0e123be5f2654b6f"
      },
      "color": "#0c797d",
      "count": 16,
      "cover": [
        "https://up.raindrop.io/collection/thumbs/849/239/3/333ce18769311113836cf93a223a14a3.png"
      ],
      "created": "2019-10-09T11:49:53.518Z",
      "expanded": false,
      "lastUpdate": "2019-11-27T17:51:19.085Z",
      "public": false,
      "sort": 8492393,
      "title": "Development",
      "user": {
        "$id": 32
      },
      "view": "list"
    }
  ]
}

Get child collections

GET https://api.raindrop.io/rest/v1/collections/childrens

Returns JSON-encoded array containing all nested collections (that have positive parent.$id)

200

{
  "result": true,
  "items": [
    {
      "_id": 8492393,
      "access": {
        "level": 4,
        "draggable": true
      },
      "collaborators": {
        "$id": "5dc1759a0e123be5f2654b6f"
      },
      "color": "#0c797d",
      "count": 16,
      "cover": [
        "https://up.raindrop.io/collection/thumbs/849/239/3/333ce18769311113836cf93a223a14a3.png"
      ],
      "created": "2019-10-09T11:49:53.518Z",
      "expanded": false,
      "lastUpdate": "2019-11-27T17:51:19.085Z",
      "parent": { "$id": 1111 },
      "public": false,
      "sort": 8492393,
      "title": "Development",
      "user": {
        "$id": 32
      },
      "view": "list"
    }
  ]
}

Get collection

GET https://api.raindrop.io/rest/v1/collection/{id}

Path Parameters

Name	Type	Description
id	number	Collection ID

200

{
  "result": true,
  "item": {
    "_id": 8492393,
    "access": {
      "for": 32,
      "level": 4,
      "root": true,
      "draggable": true
    },
    "author": true,
    "collaborators": {
      "$id": "5dc1759a0e123be5f2654b6f"
    },
    "color": "#0c797d",
    "count": 16,
    "cover": [
      "https://up.raindrop.io/collection/thumbs/849/239/3/333ce18769311113836cf93a223a14a3.png"
    ],
    "created": "2019-10-09T11:49:53.518Z",
    "expanded": false,
    "lastUpdate": "2019-11-27T17:51:19.085Z",
    "public": false,
    "sort": 8492393,
    "title": "Development",
    "user": {
      "$id": 32
    },
    "view": "list"
  }
}

Create collection

POST https://api.raindrop.io/rest/v1/collection

Create a new collection

Request Body

Name	Type	Description
view	string	More details in "Fields"
title	string	Name of the collection
sort	number	The order of collection (descending). Defines the position of the collection among all the collections with the same parent.$id
public	boolean	Collection and raindrops that it contains will be accessible without authentication?
parent.$id	integer	The ID of parent collection. Empty for root collections
cover	array	Collection cover url

200

{
    "result": true,
    "item": {
        ...
    }
}

400 Incorrect 'view' field value

{
    "result": false,
    "error": "view",
    "errorMessage": "Collection validation failed: view: `bla` is not a valid enum value for path `view`."
}

Update collection

PUT https://api.raindrop.io/rest/v1/collection/{id}

Update an existing collection

Path Parameters

Name	Type	Description
id	number	Existing collection id

Request Body

Name	Type	Description
expanded	boolean	Whether the collection`s sub-collections are expanded
view	string	More details in "Fields"
title	string	Name of the collection
sort	number	The order of collection (descending). Defines the position of the collection among all the collections with the same parent.$id
public	boolean	Collection and raindrops that it contains will be accessible without authentication?
parent.$id	integer	The ID of parent collection. Empty for root collections
cover	array	Collection cover url

200

{
    "result": true,
    "item": {
        ...
    }
}

Upload cover

PUT https://api.raindrop.io/rest/v1/collection/{id}/cover

It's possible to upload cover from desktop. PNG, GIF and JPEG supported

Path Parameters

Name	Type	Description
id	string	Existing collection ID

Headers

Name	Type	Description
Content-Type	string	multipart/form-data

Request Body

Name	Type	Description
cover	object	File

200

{
    "result": true,
    "item": {
        ...
    }
}

Remove collection

DELETE https://api.raindrop.io/rest/v1/collection/{id}

Remove an existing collection and all its descendants. Raindrops will be moved to "Trash" collection

Path Parameters

Name	Type	Description
id	number	Existing collection ID

200

{
    "result": true
}

Remove multiple collections

DELETE https://api.raindrop.io/rest/v1/collections

Remove multiple collections at once. Nested collections are ignored (include ID's in ids array to remove them)

Request Body

Name	Type	Description
ids	array	Array of collection ID

200

Reorder all collections

PUT https://api.raindrop.io/rest/v1/collections

Updates order of all collections

Request Body

Name	Type	Description
sort	string	Change order of all collections. Possible values: "title" - sort alphabetically ascending "-title" - sort alphabetically descending "-count" - sort by raindrops count descending

200

{
    "result": true
}

Expand/collapse all collections

PUT https://api.raindrop.io/rest/v1/collections

Path Parameters

Name	Type	Description
expanded	boolean	TRUE = expand all FALSE = collapse all

200

{
    "result": true
}

Merge collections

PUT https://api.raindrop.io/rest/v1/collections/merge

Merge multiple collections

Request Body

Name	Type	Description
to	number	Collection ID where listed collection ids will be merged
ids	array	Collection ID's

200

Remove all empty collections

PUT https://api.raindrop.io/rest/v1/collections/clean

200

{
    "result": true,
    "count": 3
}

Empty Trash

DELETE https://api.raindrop.io/rest/v1/collection/-99

200

{
  "result": true
}

Get system collections count

GET https://api.raindrop.io/rest/v1/user/stats

200

{
  "items": [
    {
      "_id": 0,
      "count": 1570
    },
    {
      "_id": -1,
      "count": 34
    },
    {
      "_id": -99,
      "count": 543
    }
  ],
  "meta": {
    "pro": true,
    "_id": 32,
    "changedBookmarksDate": "2020-02-11T11:23:43.143Z",
    "duplicates": {
      "count": 3
    },
    "broken": {
      "count": 31
    }
  },
  "result": true
}