Import

Handy methods to implement import functionality

get
Parse URL

https://api.raindrop.io/rest/v1/import/url/parse
Parse and extract useful info from any URL
Request
Response
Request
Query Parameters
url
required
string
URL
Response
200: OK
//Success
{
"item": {
"title": "Яндекс",
"excerpt": "Найдётся всё",
"media": [
{
"type": "image",
"link": "http://yastatic.net/s3/home/logos/share/share-logo_ru.png"
}
],
"type": "link",
"meta": {
"possibleArticle": false,
"canonical": "https://ya.ru",
"site": "Яндекс",
"tags": []
}
},
"result": true
}
//Invalid URL
{
"error": "not_found",
"errorMessage": "invalid_url",
"item": {
"title": "Fdfdfdf",
"excerpt": "",
"media": [
{
"link": "<screenshot>"
}
],
"type": "link",
"parser": "local",
"meta": {
"possibleArticle": false,
"tags": []
}
},
"result": true
}
//Not found
{
"error": "not_found",
"errorMessage": "url_status_404",
"item": {
"title": "Some",
"excerpt": "",
"media": [
{
"link": "<screenshot>"
}
],
"type": "link",
"parser": "local",
"meta": {
"possibleArticle": false,
"tags": []
}
},
"result": true
}

post
Check URL(s) existence

https://api.raindrop.io/rest/v1/import/url/exists
Does specified URL's are already saved?
Request
Response
Request
Path Parameters
urls
required
array
URL's
Response
200: OK
ids array contains ID of existing bookmarks
{
"ids": [
3322,
12323
]
}

post
Parse HTML import file

https://api.raindrop.io/rest/v1/import/file
Convert HTML bookmark file to JSON. Support Nestcape, Pocket and Instapaper file formats
Request
Response
Request
Headers
Content-Type
required
string
multipart/form-data
Form Data Parameters
import
required
string
File
Response
200: OK
{
"result": true,
"items": [
{
"title": "Web",
"folders": [
{
"title": "Default",
"folders": [],
"bookmarks": [
{
"link": "https://aaa.com/a",
"title": "Name 1",
"lastUpdate": "2016-09-13T11:17:09.000Z",
"tags": ["tag"],
"excerpt": ""
}
]
}
],
"bookmarks": [
{
"link": "https://bbb.com/b",
"title": "Name 2",
"lastUpdate": "2016-09-13T11:17:09.000Z",
"tags": ["tag"],
"excerpt": ""
}
]
},
{
"title": "Home",
"folders": [
{
"title": "Inspiration",
"folders": [],
"bookmarks": [
{
"link": "https://ccc.com/c",
"title": "Name 3",
"lastUpdate": "2016-09-13T11:17:09.000Z",
"tags": ["tag"],
"excerpt": ""
}
]
}
],
"bookmarks": []
}
]
}