Multiple raindrops

In this page you will find how to retrieve, create, update or delete multiple raindrops at once.

Common parameters

To filter, sort or limit raindrops use one of the parameters described below. Check each method for exact list of supported parameters.

Parameter

Type

Description

collectionId

Integer

Path parameter that specify from which collection to get raindrops. Or specify one of system:

0 to get all (except Trash)

-1 to get from "Unsorted"

-99 to get from "Trash"

Warning: update or remove methods not support 0 yet. Will be fixed in future.

search

String

As text, check all examples here

You can first test your searches in Raindrop app and if it works correctly, just copy content of search field and use it here

sort

String

Query parameter for sorting:

-created by date descending (default)

created by date ascending

score by relevancy (only applicable when search is specified)

-sort by order

title by title (ascending)

-title by title (descending)

domain by hostname (ascending)

-domain by hostname (descending)

page

Integer

Query parameter. 0, 1, 2, 3 ...

perpage

Integer

Query parameter. How many raindrops per page. 50 max

ids

Array<Integer>

You can specify exact raindrop ID's for batch update/remove methods

Get raindrops

GET https://api.raindrop.io/rest/v1/raindrops/{collectionId}

Path Parameters

NameTypeDescription

collectionId*

number

Collection ID. Specify 0 to get all raindrops

Query Parameters

NameTypeDescription

sort

string

perpage

number

page

number

search

string

Create many raindrops

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

Request Body

NameTypeDescription

items*

array

Array of objects. Format of single object described in "Create single raindrop". Maximum 100 objects in array!

{
    "result": true,
    "items": [
        {
            ...
        }
    ]
}

Update many raindrops

PUT https://api.raindrop.io/rest/v1/raindrops/{collectionId}

Specify optional search and/or ids parameters to limit raindrops that will be updated. Possible fields that could be updated are described in "Body Parameters"

Path Parameters

NameTypeDescription

collectionId*

number

Request Body

NameTypeDescription

ids

array

important

boolean

TRUE - mark as "favorite" FALSE - unmark as "favorite"

tags

array

Will append specified tags to raindrops. Or will remove all tags from raindrops if [] (empty array) is specified

media

array

Will append specified media items to raindrops. Or will remove all media from raindrops if [] (empty array) is specified

cover

string

Set URL for cover. Tip: specify <screenshot> to set screenshots for all raindrops

collection

object

Specify {"$id": collectionId} to move raindrops to other collection

Remove many raindrops

DELETE https://api.raindrop.io/rest/v1/raindrops/{collectionId}

Specify optional search and/or ids parameters to limit raindrops that will be moved to "Trash" When :collectionId is -99, raindrops will be permanently removed!

Path Parameters

NameTypeDescription

collectionId*

number

Query Parameters

NameTypeDescription

search

string

Request Body

NameTypeDescription

ids

array

{
    "result": true,
    "modified": 330
}

Last updated