Collection methods

Get root collections

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

Returns JSON-encoded array containing all root collections

{
  "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)

{
  "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

NameTypeDescription

id

number

Collection ID

{
  "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

NameTypeDescription

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

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

Update collection

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

Update an existing collection

Path Parameters

NameTypeDescription

id

number

Existing collection id

Request Body

NameTypeDescription

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

{
    "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

NameTypeDescription

id

string

Existing collection ID

Headers

NameTypeDescription

Content-Type

string

multipart/form-data

Request Body

NameTypeDescription

cover

object

File

{
    "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

NameTypeDescription

id

number

Existing collection ID

{
    "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

NameTypeDescription

ids

array

Array of collection ID

Reorder all collections

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

Updates order of all collections

Request Body

NameTypeDescription

sort

string

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

{
    "result": true
}

Expand/collapse all collections

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

Path Parameters

NameTypeDescription

expanded

boolean

TRUE = expand all FALSE = collapse all

{
    "result": true
}

Merge collections

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

Merge multiple collections

Request Body

NameTypeDescription

to

number

Collection ID where listed collection ids will be merged

ids

array

Collection ID's

Remove all empty collections

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

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

Empty Trash

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

{
  "result": true
}

Get system collections count

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

{
  "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
}

Last updated