Saved.io API 2.0

Authentication

Each request must include a developer api key and a user key. The user key is instead of using the users username and password.

The user key needs to be generated by an authenticated Saved.io user, on this page.

The developer key can be generated on this page. Please don't use multiple dev keys on a single application or server. Each developer key and server IP is rate limited to ~3000 requests per hour. Get in touch if you need higher limits.

Bookmarks

Retrieve All bookmarks

Returns the most recent bookmarks limited to 50 (by default) at a time.

GET http://devapi.saved.io/bookmarks

Params

devkey: your developer key

key: the user key

page: INT. (optional. Default is 1)

limit: INT. (optional. Default is 50)

list: Name of list (optional)

Retrieve Single Bookmark

Returns a single bookmark when given the bookmark ID (bk_id)

GET http://devapi.saved.io/bookmarks/[bk_id]

Params

devkey: your developer key

key: the user key

Create a Bookmark

POST http://devapi.saved.io/bookmarks/

Params

devkey: your developer key

key: the user key

url: The url you want to save

title: The title of the url you want to save

list: Name of the list to add bookmark to (optional)

Response:

id: the id of the newly created bookmark

Delete a Bookmark

DELETE http://devapi.saved.io/bookmarks/

Params

devkey: your developer key

key: the user key

id: the bk_id of the bookmark