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
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.
Last modified 1yr ago
Copy link