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
Body Parameters
urls
required
array
URL's
Response
200: OK
ids array contains ID of existing bookmarks
//Found
{
    "result": true,
    "ids": [
        3322,
        12323
    ]
}
​
//Not found
{
    "result": false,
    "ids": []
}
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": []
    }
  ]
}
Rest API v1 - Previous
Filters
Next - More
Changelog
Last updated 10 months ago
Import

getParse URL

postCheck URL(s) existence

postParse HTML import file

get
Parse URL

post
Check URL(s) existence

post
Parse HTML import file
