Comment on page
Build and integrate tools and applications to help members manage their bookmarks on Raindrop.io
This is the official documentation for Raindrop.io API. A reference to the functionality our public API provides with detailed description of each API endpoint, parameters, and examples.
API endpoints accept arguments either as url-encoded values for non-POST requests or as json-encoded objects encoded in POST request body with
Where possible, the API strives to use appropriate HTTP verbs for each action.
This API relies on standard HTTP response codes to indicate operation result. The table below is a simple reference about the most used status codes:
200 OKresponses have the
Content-type: application/jsonand contain a JSON-encoded representation of one or more objects.
Payload of POST requests has to be JSON-encoded and accompanied with
All timestamps are returned in ISO 8601 format:
For requests using OAuth, you can make up to 120 requests per minute per authenticated user.
The headers tell you everything you need to know about your current rate limit status:
Once you go over the rate limit you will receive an error response:
HTTP/1.1 429 Too Many Requests
Status: 429 Too Many Requests
Here’s a sample request sent from a browser hitting
HTTP/1.1 200 OK
Access-Control-Expose-Headers: ETag, Content-Type, Accept, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset