Raindrops

We call bookmarks (or items) as "raindrops"

Main fields

Field

Type

Description

_id

Integer

Unique identifier

collection

Object

collection.$id

Integer

Collection that the raindrop resides in

cover

String

Raindrop cover URL

created

String

Creation date

domain

String

Hostname of a link. Files always have raindrop.io hostname

excerpt

String

Description; max length: 10000

lastUpdate

String

Update date

link

String

URL

media

Array<Object>

​Covers list in format: [ {"link":"url"} ]

tags

Array<String>

Tags list

title

String

Title; max length: 1000

type

String

link article image video document or audio

user

Object

user.$id

Integer

Raindrop owner

Other fields

Field

Type

Description

broken

Boolean

Marked as broken (original link is not reachable anymore)

cache

Object

Permanent copy (cached version) details

cache.status

String

ready retry failed invalid-origin invalid-timeout or invalid-size

cache.size

Integer

Full size in bytes

cache.created

String

Date when copy is successfully made

creatorRef

Object

Sometime raindrop may belong to other user, not to the one who created it. For example when this raindrop is created in shared collection by other user. This object contains info about original author.

creatorRef._id

Integer

Original author (user ID) of a raindrop

creatorRef.fullName

String

Original author name of a raindrop

file

Object

This raindrop uploaded from desktop

Supported file formats

file.name

String

File name

file.size

Integer

File size in bytes

file.type

String

Mime type

important

Boolean

Marked as "favorite"

html

String

When raindrop have article, image, video or document type, this field will contain preview in HTML format.

This field send only for single GET raindrop request

Our API response could contain other fields, not described above. It's unsafe to use them in your integration! They could be removed or renamed at any time.